SHAFT
Java 25 automation framework for Web, Mobile, API, CLI, and Database testing.
SHAFT is a Maven-published test automation engine with one fluent API for synchronized actions, assertions, configuration, test data, reporting, evidence, and optional agent-assisted workflows.
User Guide · Quick Start · Architecture · Contribute
What SHAFT Provides
- Web, mobile, API, CLI, database, validation, test data, and reporting APIs.
- Built-in synchronization, assertions, screenshots, logs, and Allure evidence.
- TestNG, JUnit 5, and Cucumber integration.
- Required
shaft-engineruntime plus optional modules for MCP, Capture, Doctor, Heal, AI providers, BrowserStack, local video, and visual processing. - Deterministic agent workflows through SHAFT MCP, Capture, Doctor, and Heal, with provider-backed AI features kept optional.
Go Straight To The Guide
| Goal | Open |
|---|---|
| Evaluate SHAFT quickly | SHAFT at a glance |
| Create and run a project | Quick start |
| Install or generate a project | Installation |
| Understand artifacts and boundaries | Architecture and modules |
| Test browsers | Web testing |
| Test mobile apps | Mobile testing |
| Test REST or GraphQL APIs | API testing |
| Use agent tools | SHAFT MCP |
| Diagnose or recover failed runs | Doctor and Heal |
| Upgrade an existing project | Upgrade guide |
Evidence
SHAFT is published on Maven Central, listed in the Selenium ecosystem, and was recognized through the Google Open Source Peer Bonus program.
Contribute
Read CONTRIBUTING.md for the full local setup, validation, documentation, and pull request checklist.
Public product documentation is maintained in ShaftHQ/shafthq.github.io. User-facing engine changes need a linked documentation pull request or a clear reason why documentation is not required.
MIT licensed. See LICENSE.