Speedrun
Fastest cross-platform E2E Automation for Mobile & Web
Black-box UI tests for Android, iOS and the web, written in plain YAML.

The same 15-step test of Android's Settings app (flow) on one emulator, in real time.
Speedrun tests your app the way a user uses it: it taps, types, scrolls and checks what is on screen, from outside the app, with nothing added to it. A test is a short YAML file:
appId: com.example.app
---
- launchApp
- tapOn: "Sign in"
- inputText: "user@example.com"
- tapOn: "Continue"
- assertVisible: "Welcome"
Why Speedrun?
- Fast. A tap that opens a screen takes about 0.3 s, and a run starts in 1–3 s. The same user journey takes 20 s with Speedrun on Android, 59 s with Appium, 66 s with maestro-runner and 127 s with Maestro. In the browser, Cypress's own demo app's tests take 4.2 s with Speedrun, 5.9 s with Playwright and 11.3 s with Cypress, and Speedrun leads in Firefox too (benchmark).
- Waits for the app, not the clock. Each step starts the moment the app has finished changing: no sleeps, no comparing screenshots. Screens that never stop moving (spinners, tickers, carousels) don't hold it up.
- Fewer flaky failures. It doesn't tap a popup that is still sliding in or a button behind a loading overlay, and it scrolls an element out from under a sticky footer or the keyboard before tapping it, so the same flow passes on a small phone.
- Black-box. Any build of your app, release builds included, through the platform's accessibility layer. Tested on native and React Native apps.
- One file. The Android and iOS agents are built in, and it drives Chrome and Firefox itself: no JVM, no WebDriver or drivers to install, no SDK in your app.
- Ready for CI. JUnit and HTML reports, sharding across devices, tags, and a debug folder with screenshots and logs for every failure. It answers the "isn't responding" dialogs a freshly booted emulator puts up, reconnects to its agent if the agent crashes, and boots iOS simulators without the background services that slow a runner's first minutes (Running on CI).
Quick start
Install with Homebrew (macOS on Apple silicon, Linux x86_64):
brew install hubastard/tap/speedrunOr with the install script:
curl -fsSL https://raw.githubusercontent.com/hubastard/speedrun/main/install.sh | bashOther ways to install, updating, and building from source: Install.
Write a flow (how), or use the ones you have:
# login.yaml appId: com.example.app --- - launchApp: clearState: true - tapOn: "Email" - inputText: "user@example.com" - tapOn: "Password" - inputText: ${PASSWORD} - tapOn: "Sign in" - assertVisible: "Welcome"Run it on a running Android emulator or device, or a booted iOS simulator:
speedrun test login.yaml -e PASSWORD=secret # Android speedrun test -p ios login.yaml -e PASSWORD=secret # iOS simulator speedrun test flows/ --format junit --output report.xml # a whole suite, for CI
From the project's README.