Quickstart

Prerequisites

A Revyl account with cloud-build credits and available capacity
Your mobile app project in a Git worktree
A Revyl app for the selected platform, with its UUID configured in the recipe’s app_id before submission

Install the CLI

curl -fsSL https://revyl.com/install.sh | sh
revyl auth login

Run init

revyl init

revyl init creates .revyl/config.yaml with a stable project ID and detected named build profiles. Use revyl app list --platform ios (or android) to find your app UUID, or revyl app create to create one.

Configure the build

Configure the build commands in .revyl/config.yaml:

Expo
React Native
iOS
Android

build:
  framework: expo
  profiles:
    development:
      ios:
        app_id: "<your-ios-app-uuid>"
        setup_commands:
          - bun install
          - bunx expo prebuild --platform ios
          - cd ios && pod install
        build_commands:
          - cd ios && xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Release -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath build ARCHS=arm64
        output_path: ios/build/Build/Products/Release-iphonesimulator/*.app
      android:
        app_id: "<your-android-app-uuid>"
        setup_commands:
          - bun install
          - bunx expo prebuild --platform android
        build_commands:
          - cd android && ./gradlew assembleRelease
        output_path: android/app/build/outputs/apk/release/*.apk

build:
  framework: react_native
  profiles:
    development:
      ios:
        app_id: "<your-ios-app-uuid>"
        setup_commands:
          - npm install
          - cd ios && pod install
        build_commands:
          - cd ios && xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Release -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath build ARCHS=arm64
        output_path: ios/build/Build/Products/Release-iphonesimulator/*.app
      android:
        app_id: "<your-android-app-uuid>"
        setup_commands:
          - npm install
        build_commands:
          - cd android && ./gradlew assembleRelease
        output_path: android/app/build/outputs/apk/release/*.apk

build:
  framework: ios
  profiles:
    development:
      ios:
        app_id: "<your-ios-app-uuid>"
        build_commands:
          - xcodebuild -project YourApp.xcodeproj -scheme YourApp -configuration Release -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath build ARCHS=arm64
        output_path: build/Build/Products/Release-iphonesimulator/*.app

build:
  framework: android
  profiles:
    development:
      android:
        app_id: "<your-android-app-uuid>"
        build_commands:
          - ./gradlew assembleRelease
        output_path: app/build/outputs/apk/release/*.apk

For the full set of build options — artifact requirements, environment variables, toolchain images, and more — see Configuration.Replace the app_id placeholders with your app UUIDs and validate the config:

revyl config validate

Run the build

revyl build --profile development --platform ios

The profile and platform select one recipe, which runs in the cloud by default. When an omitted value has exactly one eligible choice, the CLI resolves it. Otherwise, interactive use prompts and non-interactive use fails with the available choices. No profile is stored as active or default.Cloud builds upload your working tree. --branch <name> selects the Revyl destination branch; omitting it uses the app default branch. Keep secrets out of source and use encrypted build secrets instead.Useful variations:

revyl build --profile development --platform ios --debug     # stream full build logs
revyl build --profile development --platform android --json  # machine-readable result
revyl build --profile development --platform ios --detach    # queue and return a job ID

For a detached build:

revyl build status <build-job-id> --follow
revyl build cancel <build-job-id>

Use the build

The new version is registered in the selected app branch. With --json, a completed remote build returns status: success and build_version_id. A detached submission returns build_job_id; monitor it with build status, whose successful JSON result contains version_id. Use that uploaded build ID to boot a device and run a test against the exact artifact:

revyl device start --platform ios --build-version-id <uploaded-build-id>
revyl test run <test-alias> --build-id <uploaded-build-id>

To refresh a shared Atlas after merges or weekly, use the maintenance recipe, which explores the exact uploaded build and handles bounded monitoring and cleanup.

If the build fails

Check the log tail printed by revyl build. You can also run:

revyl build status <build-id>

That shows where the build failed and the most recent logs.

Next steps

Configuration

Named profiles, inherited recipe values, and all CLI flags.

Caching

Speed up repeat builds with compilation and configured path caches.

Toolchain Images

Pin the Xcode or Android toolchain version.

GitHub Integration

Build every pull request automatically.

Getting Started

CLI

Builds

Tests

Develop

Atlas

Integrations

Device Infrastructure

Appendix

Prerequisites

If the build fails

Next steps

Configuration

Caching

Toolchain Images

GitHub Integration

​Prerequisites

​If the build fails

​Next steps

Configuration

Caching

Toolchain Images

GitHub Integration

Prerequisites

If the build fails

Next steps