Quickstart

Prerequisites

A Revyl account
Your mobile app project

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. Review the generated recipe before running it.

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.

Run the build

revyl build --profile development --platform ios --remote

The profile and platform select one recipe. Local and remote builds select that same recipe; --remote executes it on a cloud runner. 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.Useful variations:

revyl build --profile development --platform ios --remote --debug     # stream full build logs
revyl build --profile development --platform android --remote --json  # machine-readable result
revyl build --profile development --platform ios --remote --detach    # queue and return a build 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 on your app and set as current. Boot a device with it and run a test:

revyl device start --platform ios --app-id <your-ios-app-uuid>
revyl test run <test-alias>

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

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