SHAFT Engine · open-source Java test automation framework

Write the test. SHAFT does the rest.

One Java engine for web, mobile, API, CLI, database, and desktop. Drivers, waits, and evidence are handled. Every run ends in an Allure report.

Create new project Read the user guide

Star on GitHub

Your first run

Generate project
mvn test
Inspect report

Already on Maven? Install SHAFT · See agent-to-evidence workflow

Real run, no mockups. A 3-line test, mvn test, and the report it writes.

Three lines in. A green report out.

Write

QuickStartTest.java
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser()
      .navigateToURL("https://shafthq.github.io/")
      .and().element().assertThat(By.cssSelector("h1")).isVisible();
driver.quit();

Run

Terminal
$ mvn test
[INFO] Running hero.QuickStartTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

Prove

Output from a real run of this test. Open the report to inspect every step, screenshot, and log.

Usage, measured

Public SHAFT traffic from Google Analytics 4 (Engine property) and GitHub. Exact counts, not rounded up. As of 2026-10-29.

4,885,097Tests run in 30 days (2026-09-29 to 2026-10-28)

53,062Active users in 30 days (2026-09-29 to 2026-10-28)

154,202Active users in 12 months (2025-10-29 to 2026-10-28)

36Countries in 12 months (2025-10-29 to 2026-10-28)

Source: GA4 property Engine (504911558) + GitHub API. Stars on this page come from the live GitHub count (418 as committed baseline); releases snapshot 227.

See SHAFT in 100 seconds

Why teams pick SHAFT for new Java suites, and how an existing Selenium suite moves over without a rewrite. Captions are on; nothing downloads until you press play.

0:00 Red build: bug or flaky test?
0:20 One engine on proven tools
0:36 Waits, reports and scale built in
0:57 Upgrade an existing suite
1:16 Open source, and how to start

Prefer the technical walkthrough? Watch it in the quick start.

From intent to reviewable Java and evidence.

Capture a flow, review the Java it generates, and diagnose failures from the evidence. Engineers stay in control; leads get a release signal they can inspect.

Capture lifecycle

`capture_start` `capture_stop` `capture_generate_replay`

Capture an approved flow, review generated native Java, then retain replay evidence with the recording.

Reviewed native Java
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://example.com");
driver.element().click(By.id("submit"));

Evidence first

Failed Allure or trace evidence classified cause review-only remediation guidance

Run doctor_analyze_failed_allure or doctor_analyze_trace to classify evidence before reviewing a proposal.

Doctor output
classification: locator
evidence: failed Allure action and trace context
next step: review remediation guidance

Model choice remains with the MCP client. Tests remain ordinary Java. Proposals do not silently edit, approve, or merge.

Pick your starting point

Most teams start with one of these three. Upgrading an older suite? The quick start also covers the existing-project upgrade.

Create a project

Generate a Maven project and run the sample.

Create a project

Upgrade a Java project

Move an existing Maven suite onto current SHAFT and run one test.

Upgrade a project

Run in CI

Run the suite headlessly and keep the report.

Run in CI

Agents and IDE

Install skillsAdd the SHAFT skill pack to the agent you already use.
Use the IntelliJ pluginOpen the SHAFT tool window and finish setup.
Connect an MCP clientList SHAFT tools in Codex, Copilot, Claude, or another client.
Use shaft-cliRun one SHAFT command from the terminal.
Install ChaosEngineInstall the project-local agent harness and read the result.

Surfaces and infrastructure

Add a test surfaceAdd web, API, mobile, database, or CLI to a project that already runs.
Install local infrastructureInstall the Android, Appium, Grid, or browser profile you chose.

One evidence model across six test surfaces

Each surface runs on its native engine. The suite, the API style, and the report stay the same.

Native engine

Selenium WebDriver

Actions, screenshots, trace context, and Allure steps.

Read web guide

Web SHAFT snippet
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://example.com");
driver.element().click(By.id("submit"));

Native engine

Appium

Touch actions, device context, screenshots, and native trace evidence.

Read mobile guide

Mobile SHAFT snippet
driver.touch().tap(SHAFT.GUI.Locator.accessibilityId("Views"));
driver.assertThat().element(By.id("screen")).exists().perform();

Native engine

Appium Windows driver

The same click and type facade as web, with UIA control routing and report evidence.

Read desktop guide

Desktop SHAFT snippet
SHAFT.Properties.platform.set()
        .targetPlatform("Windows")
        .executionAddress("http://127.0.0.1:4723");
new DriverFactory().getHelper(DriverFactory.DriverType.APPIUM_WINDOWS);

Native engine

REST Assured

Requests, responses, assertions, and report attachments.

Read api guide

API SHAFT snippet
SHAFT.API api = new SHAFT.API(apiFixtureUrl);
api.get("users").performRequest();

Native engine

JDBC

Connection target, query result, validation, and report evidence.

Read database guide

Database SHAFT snippet
SHAFT.DB database = new SHAFT.DB("jdbc:h2:mem:test");
ResultSet rows = database.executeSelectQuery("SELECT 1");

Native engine

Local, Docker, SSH

Commands, captured output, and validation in the same report.

Read cli guide

CLI SHAFT snippet
String output = SHAFT.CLI.terminal()
        .performTerminalCommand("echo Hello SHAFT");

Open, current, and checked

SHAFT releaseSHAFT 10.4.20261031 is the current release on Maven Central.Java baselineBuilds and runs on Java 25.MIT licenseUse, fork, and inspect it under a permissive license.CI gateEvery pull request runs the same public checks.Selenium ecosystemListed in Selenium’s official ecosystem directory.

Common questions

What is SHAFT Engine?

SHAFT Engine is an open-source Java test automation engine for web, mobile, API, CLI, database, and desktop. It wraps Selenium, Appium, and REST Assured behind one fluent API and writes an Allure report on every run. The user guide is at https://shafthq.github.io/.

Is SHAFT free to use?

Yes. SHAFT is open source under the MIT license.

Do I have to rewrite my Selenium tests?

No. Move an existing Maven suite onto current SHAFT and run one test first. See Upgrade a project in the user guide.

Which Java version do I need?

Java 25. Installation lists the rest.

What Maven coordinate do I use?

Use io.github.shafthq:shaft-engine with the version from Maven Central (or shaft-bom). The legacy SHAFT_ENGINE coordinate is a relocation only.

Who created SHAFT_ENGINE?

Mohab Mohie created SHAFT_ENGINE and maintains it with the ShaftHQ community. See the Welcome blog post on the user guide.

إيه إطار Java ينفع لاختبارات Selenium وAppium والـ API والـ desktop؟

SHAFT Engine إطار أتمتة اختبارات مفتوح المصدر بلغة Java بيغطي الويب والموبايل والـ API والـ CLI وقواعد البيانات والـ desktop. مبني على Selenium وAppium وREST Assured، وبيطلع تقرير Allure مع كل تشغيل. الدليل: https://shafthq.github.io/.

SHAFT مجاني؟

أيوه. SHAFT مفتوح المصدر بترخيص MIT.

مين عمل SHAFT_ENGINE؟

مهاب محيي (Mohab Mohie) منشئ SHAFT_ENGINE، وبيحافظ عليه مع مجتمع ShaftHQ. شوف تدوينة Welcome على دليل المستخدم.

Write your first test today.

Generate a starter project, read the guide, or star the repo so other testers find it.

Create new project Read the user guide

Star on GitHub

Supported by

Tooling and open-source program support only — not sponsorship or endorsement. JetBrains and the JetBrains logo are trademarks of JetBrains s.r.o. DXC Technology imagery is reproduced courtesy of DXC Technology; unauthorized use is not permitted.