Dev Scenario Docs
Getting started / Quickstart

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.

Note — physical iPhones need Xcode and a developer team ID. See the setup guide.

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:

login.ds
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 ||.

stores.ds
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.