Skip to content

Your first test

Terminal window
tapstep login # once — see Installation
tapstep init # writes example.flow.yaml — a real web flow
tapstep test example.flow.yaml # driver auto-detected (URL appId → Chrome)

The starter flow opens https://example.com, so it needs a browser and network (no browser? --browser managed, see Installation).

A flow is plain YAML:

appId: https://staging.example.com
commands:
- launchApp: https://staging.example.com
- tapOn: "Log in"
- inputText: "demo@example.com"
- tapOn: "Continue"
- assertVisible: "Welcome"

Useful while iterating:

Terminal window
tapstep validate example.flow.yaml # parse-check it, no device needed
tapstep test example.flow.yaml --headed # watch a real browser window
tapstep test example.flow.yaml -c # re-run on every file save
tapstep live example.flow.yaml # interactive live view in the browser

Prefer clicking to typing? The desktop app records flows for you — click through your app in your own browser window (or a mirror, on a phone) and the steps appear beside it as you go.

Next: the flow command reference and config.yaml for workspace defaults.