Testing
SootSim runs your React Native app in a browser, which changes what mobile
testing costs. There is no simulator to boot, no .app to build, and no macOS
runner to rent: a test suite that needs minutes of Xcode and simulator time
elsewhere runs in seconds on an ordinary Linux CI box, or straight on your
laptop against the dev server you already have running.
Your existing tests come along unchanged:
- Maestro suites run with
sootsim maestro testas a drop-in for themaestroCLI. Your.maestro/*.yamlfiles work as they are. - Detox suites run with
sootsim detox, which remaps thedetoximport to the SootSim driver inside your own Jest setup. - New Maestro tests can be written as YAML, authored from live actions, or
generated with
sootsim maestro generate "log in and post a photo".
Every run can also upload a hosted, replayable result: a link your whole team opens to watch the recording, scrub through the steps, and inspect what the app did, with pass/fail indexed in your org dashboard and posted to the pull request.
The path to your first green test in CI
- Run a suite locally against your dev server. If you use Detox, start at Detox suites instead. No account needed.
- Run it on every pull request with the SootSim GitHub App. Your repo keeps zero secrets; results post to the PR as a comment and a check.
- Read the results in the org dashboard: every run with pass/fail, per-step traces, and a replay link, filterable by repo, branch, or pull request.
Which lane fits
| you have | use | page |
|---|---|---|
.maestro/ flows | sootsim maestro test | Maestro suites |
| Detox e2e specs | sootsim detox | Detox suites |
| no tests yet | sootsim maestro init, or sootsim maestro generate "<goal>" | Maestro suites, Generate a Maestro test |
| GitHub PRs to gate | the SootSim GitHub App | Tests in CI |
Local runs and CI exit codes are free and need no account. Hosted replays and the dashboard run index ride your team’s plan; see Plans.
