Quickstart
Write and run your first flow on an Android emulator or iOS simulator in about five minutes.
1. Install and open the app
Download Dev Scenario for macOS (Windows and Linux are coming soon). Your free 6-week trial starts the first time you open it.
2. Connect a device
Start an emulator or simulator, or plug in a phone. It appears in the device picker at the top of the window.
3. Write a flow
Every command is listed in the command reference. A flow is a plain .ds text file, one command per line. Create login.ds and paste:
launchApp(androidAppId = "com.acme.shop", iosAppId = "com.acme.shop.ios") tap("Sign in") type(@username) tap("Continue") assertVisible("Welcome back")
4. Run it
Press Run. Each step turns green as it passes. If one fails, the run report opens on that step with its screenshot.
5. Branch on device state
Use if to run steps only when a permission is allowed or denied. Combine checks with && and ||.
tap("Stores near me") if (permission(location) == denied) { assertVisible("Enable location") tap("Open settings") } if (permission(location) == allowed || permission(camera) == allowed) { assertVisible("Stores near you") }
Next: faster runs and network logs
Everything above works on any build, with no changes to your app. When you want Espresso-speed runs or to see and mock the app's network calls, add the debug-only libraries — see how Dev Scenario drives your app.
To run your regression on every pull request, on one device or several at once, see Run tests in CI.