Repolode
tester-army

tester-army/e2e

An end-to-end testing framework for web and mobile apps that lets you describe test goals in natural language and drive the app with an agent.

Open-source alternative to:MablTestim

Stars
11,302
Forks
577
Open issues
75
Last commit
21 hours ago

What is it?

e2e is an end-to-end testing framework for web and mobile apps. Tests are written in TypeScript and can combine agent steps, where a goal is described in natural language and an agent operates the app to reach it, with conventional locators and assertions in the same test.

An agent step that a later assertion verifies records its actions, and subsequent runs replay those actions without model calls until the app changes. Tests without agent steps do not need a model. Model access can come from a subscription, an API key, or a local model.

The web engine runs on Chromium, Firefox, and WebKit through Playwright, and the mobile engine drives iOS simulators and Android emulators through agent-device. Running `npx e2e init` sets up a config and example test, and the repository includes example projects for Vite, Next.js, Astro, Expo, SwiftUI, Jetpack Compose, Kotlin Multiplatform, Flutter, and .NET MAUI.

Key features

  • 01Write tests that mix natural-language agent steps with locators and assertions.
  • 02Replays recorded agent actions without model calls until the app changes.
  • 03Web engine supports Chromium, Firefox, and WebKit via Playwright.
  • 04Mobile engine drives iOS simulators and Android emulators.
  • 05Works with a subscription, an API key, or a local model.
  • 06Includes a GitHub reporter that posts results as a pull request comment.

Use cases

  • End-to-end testing of a web app's critical user flows such as checkout or billing upgrades.
  • Running the same test suite across web and iOS/Android apps.
  • Adding automated UI checks to pull requests in CI.
  • Writing tests in plain language when selector-based scripts are hard to maintain.

Quick start

  1. 1

    Run the init command to create a config and example test

    npx e2e init
  2. 2

    Read the quickstart guide for the remaining setup

Things to know

  • Requires a model provider subscription, API key, or local model for agent steps.
  • The project is in active development ahead of 1.0, so APIs and config may change between minor releases.
  • Mobile testing relies on simulators, emulators, or hosted devices.

Topics

FAQ

What is e2e?
An end-to-end testing framework for web and mobile apps that lets you describe test goals in natural language and drive the app with an agent. e2e is an end-to-end testing framework for web and mobile apps. Tests are written in TypeScript and can combine agent steps, where a goal is described in natural language and an agent operates the app to reach it, with conventional locators and assertions in the same test.
Is e2e free to use? What license does it have?
e2e is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is e2e still maintained?
Actively maintained. The last commit to e2e was on Oct 19, 2026.
What can I use e2e for?
End-to-end testing of a web app's critical user flows such as checkout or billing upgrades. Running the same test suite across web and iOS/Android apps. Adding automated UI checks to pull requests in CI. Writing tests in plain language when selector-based scripts are hard to maintain.
How do I install e2e?
Run the init command to create a config and example test: npx e2e init Read the quickstart guide for the remaining setup
Where can I get e2e?
The source code and installation instructions are on GitHub: https://github.com/tester-army/e2e

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects