Skip to main content
Generate simulator builds for your Flutter app.

Build Guidance

To use the Dev Loop, a build is required on every code change. Dart compiles into the native binary — see Dev Loop: Hot reload and rebuild configuration for the full breakdown.

Build via the Revyl CLI

Prerequisites

  • Flutter SDK installed (flutter doctor passes)
  • Xcode (for iOS) or Android SDK (for Android)
  • Revyl CLI installed and authenticated (revyl auth login)

Setup

Initialize the project using the Revyl CLI:
This creates an app, generates the necessary Revyl configuration files, runs a build, and uploads it to Revyl.

Run Build

Run a build using: revyl build --platform [ios|android|<config-key>] Platform config keys are automatically generated and defined in the .revyl/config.yaml file. See the Configuration page for more details. This command automatically builds and uploads the app to Revyl, where you can use it to start sessions.

Advanced Configuration

When you run revyl init, Revyl makes a best-effort guess at your configuration. This section covers configuration in more detail. If the build does not complete successfully modify the build commands manually in the config.yaml file. Note: For flutter apps, use debug builds for better test reliability. Debug builds provide an accurate view hierarchy extraction, better element identification, and faster execution. Here are example commands of how to build your flutter app as a debug configuration:

Troubleshooting

Check Xcode configuration:
Clean and rebuild:
Check build output directory:

Resources