Speedrun

Fastest cross-platform E2E Automation for Mobile & Web

LLM Mart 2 views 55 listing impressions

Black-box UI tests for Android, iOS and the web, written in plain YAML.

Latest release Android, iOS and web Apache 2.0 license

The same test run by Maestro in 35.0 s and by Speedrun in 4.5 s
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

  1. Install with Homebrew (macOS on Apple silicon, Linux x86_64):

    brew install hubastard/tap/speedrun
    

    Or with the install script:

    curl -fsSL https://raw.githubusercontent.com/hubastard/speedrun/main/install.sh | bash
    

    Other ways to install, updating, and building from source: Install.

  2. 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"
    
  3. 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.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

28 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views

Control plane MCP for scoped recon, triage, and bounded proofs.

27 views