$git clone https://github.com/ShaftHQ/SHAFT_ENGINEJava 25 automation framework for Web, Mobile, API, CLI, and Database testing.
| 1 | <div align="center"> |
| 2 | |
| 3 | <picture> |
| 4 | <source media="(prefers-color-scheme: dark)" srcset="shaft-engine/src/main/resources/images/shaft_white.png"> |
| 5 | <img src="shaft-engine/src/main/resources/images/shaft_standard.png" alt="SHAFT logo" width="180"> |
| 6 | </picture> |
| 7 | |
| 8 | # SHAFT |
| 9 | |
| 10 | Java 25 automation framework for Web, Mobile, API, CLI, and Database testing. |
| 11 | |
| 12 | [](https://central.sonatype.com/artifact/io.github.shafthq/shaft-engine) |
| 13 | [](https://github.com/ShaftHQ/SHAFT_ENGINE/actions/workflows/e2eTests.yml) |
| 14 | [](https://shafthq.github.io/docs/start/overview) |
| 15 | |
| 16 | **[Open the User Guide](https://shafthq.github.io/docs/start/overview)** |
| 17 | |
| 18 | </div> |
| 19 | |
| 20 | SHAFT is a Maven-published Java automation framework that keeps the common test |
| 21 | automation plumbing in one place: drivers, synchronization, assertions, |
| 22 | configuration, test data, reporting, evidence, and optional agent-assisted |
| 23 | workflows. |
| 24 | |
| 25 | ## Why SHAFT |
| 26 | |
| 27 | - Java and Maven first, with TestNG, JUnit, and Cucumber integration. |
| 28 | - One workflow for Web, Mobile, API, CLI, Database, accessibility, reporting, |
| 29 | and evidence. |
| 30 | - Configuration-first defaults for local, grid, cloud, and CI execution. |
| 31 | - Optional modules and tools for BrowserStack, Capture, Doctor, Heal, MCP, AI, |
| 32 | IntelliJ IDEA, video, and visual testing. |
| 33 | - IntelliJ IDEA is the front-door workflow for coding partners: plan from the |
| 34 | SHAFT tool window, reuse existing code, review generated blocks, and verify |
| 35 | locally. |
| 36 | |
| 37 | ## Feature Overview |
| 38 | |
| 39 | | Area | Built in | |
| 40 | |---|---| |
| 41 | | UI automation | Browser and mobile driver management, synchronized actions, screenshots, and logs. | |
| 42 | | Service testing | REST and GraphQL API workflows with request, response, and assertion support. | |
| 43 | | System coverage | CLI and Database actions for end-to-end validation beyond the browser. | |
| 44 | | Test design | Assertions, validations, test data handling, and configuration overrides. | |
| 45 | | Reporting | Allure-ready evidence, attachments, execution logs, and accessibility artifacts. | |
| 46 | | Extensions | Optional modules and tools for cloud execution, capture, diagnostics, healing, MCP, AI, IntelliJ IDEA, video, and visual checks. | |
| 47 | |
| 48 | SHAFT is built for Java teams that want consistent APIs, repeatable |
| 49 | configuration, and useful run artifacts across the full automation suite. |
| 50 | |
| 51 | ## User Guide |
| 52 | |
| 53 | - Start: [overview](https://shafthq.github.io/docs/start/overview), [installation](https://shafthq.github.io/docs/start/installation), [upgrade](https://shafthq.github.io/docs/start/upgrade). |
| 54 | - Testing: [web](https://shafthq.github.io/docs/testing/web), [mobile](https://shafthq.github.io/docs/testing/mobile), [API](https://shafthq.github.io/docs/testing/api). |
| 55 | - Agentic workflows: [IntelliJ IDEA plugin](https://shafthq.github.io/docs/agentic/intellij), [MCP](https://shafthq.github.io/docs/agentic/mcp), [Doctor](https://shafthq.github.io/docs/agentic/doctor), [Heal](https://shafthq.github.io/docs/agentic/heal). |
| 56 | |
| 57 | ## Contributing |
| 58 | |
| 59 | Read [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, validation, and pull |
| 60 | request guidance. |
| 61 | |
| 62 | MIT licensed. See [LICENSE](LICENSE). |