SHAFT : Unified Test Automation Engine

Stop reinventing the wheel. Write your tests once and run them everywhere — across browsers, devices, and APIs — with a single, fluent Java framework.

SHAFT Engine is an open-source Java test automation framework built on top of Selenium, Appium, and REST Assured. It provides a unified, fluent API for cross-browser testing, mobile app testing, API testing, CLI testing, and database testing — so you can automate anything, from any platform, with zero boilerplate.

---

🏆 Recognition & Trust

Fully Documented

Award Winning

Selenium Ecosystem

---

📖 Table of Contents

• 🚀 Why SHAFT?
• 💡 See the Difference
• ⚡ Quick Start
• ✨ Key Features
• 🌍 Success Partners
• 📚 Documentation
• 🤝 Community & Support
• 💖 Sponsor
• 📜 License

---

🚀 Why SHAFT?

If you're tired of managing a fragile patchwork of Selenium helpers, custom wrappers, and retry logic — you're not alone. SHAFT Engine replaces all of that with a single, battle-tested framework trusted by 41,000+ engineers across 10+ countries.

Built on industry-standard technologies — Selenium, Appium, and REST Assured — SHAFT gives you a fluent, chainable API that works across web browsers, mobile apps, REST APIs, databases, and CLIs. No more boilerplate. No more flaky tests. Just results.

What Makes SHAFT Different?

Feature	What You Get
🎯 Unified API	One fluent syntax for Web, Mobile, API, CLI, and Database testing
🔧 Zero Boilerplate	Smart auto-configuration — no WebDriverManager, no manual waits, no setup code
📊 Rich Reporting	Built-in Allure integration with screenshots, videos, and detailed logs
🤖 AI-Powered Validation	Visual testing with OpenCV and intelligent element detection
🌐 Cloud-Ready	Native support for BrowserStack, LambdaTest, and Selenium Grid
⚙️ Any Test Runner	Works with TestNG, JUnit 5, and Cucumber out of the box
🐳 Containerized	Ready-to-use Docker support for CI/CD pipelines
📱 Full Mobile	Native, Hybrid, and Flutter apps on Android & iOS via Appium

Global Adoption

41,511 active users across 10+ countries trust SHAFT for their test automation needs — from startups to Fortune 500 companies.

View detailed analytics →

---

💡 See the Difference

Stop writing dozens of lines of brittle Selenium boilerplate. Here's what SHAFT looks like compared to raw Selenium:

❌ Raw Selenium (verbose & fragile)

✅ SHAFT Engine (clean & reliable)

WebDriver driver = new ChromeDriver(); driver.get("https://example.com"); WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10)); WebElement el = wait.until( ExpectedConditions.visibilityOfElementLocated( By.name("q"))); el.sendKeys("SHAFT"); el.sendKeys(Keys.ENTER); String title = driver.getTitle(); Assert.assertTrue(title.contains("SHAFT")); driver.quit();

SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver(); driver.browser().navigateToURL("https://example.com") .and().element().type(By.name("q"), "SHAFT" + Keys.ENTER) .and().assertThat().browser().title() .contains("SHAFT"); driver.quit();

Fewer lines. Automatic synchronization. Built-in assertions. Beautiful reports. That's SHAFT.

---

⚡ Quick Start

Get up and running in under 5 minutes!

Option 1: Interactive Project Generator 🎉 (Recommended)

The fastest way to create a new SHAFT project with a user-friendly web UI:

👉 Launch Project Generator

Choose your test runner (TestNG / JUnit 5 / Cucumber), select your platform (Web / Mobile / API), and download a ready-to-use project — complete with CI/CD configuration.

Option 2: Maven Archetype

Create a new project from the command line:

mvn archetype:generate \
  -DarchetypeGroupId=io.github.shafthq \
  -DarchetypeArtifactId=shaft-archetype

Option 3: Add to an Existing Project

Maven — add to your pom.xml

<dependency>
    <groupId>io.github.shafthq</groupId>
    <artifactId>SHAFT_ENGINE</artifactId>
    <!-- Get the latest version from Maven Central ↓ -->
    <version><!-- SEE BADGE BELOW --></version>
</dependency>

Gradle (Kotlin DSL) — add to your build.gradle.kts

dependencies {
    // Get the latest version from Maven Central ↓
    testImplementation("io.github.shafthq:SHAFT_ENGINE:<version>")
}

💡 Check the latest version:

Your First Test

import com.shaft.driver.SHAFT;
import org.openqa.selenium.By;
import org.testng.annotations.*;

public class QuickStartTest {
    SHAFT.GUI.WebDriver driver;

    @BeforeMethod
    public void setup() {
        driver = new SHAFT.GUI.WebDriver();
    }

    @Test
    public void searchTest() {
        driver.browser().navigateToURL("https://duckduckgo.com/")
              .and().element().type(By.name("q"), "SHAFT_Engine")
              .and().element().click(By.cssSelector("button[type='submit']"))
              .and().assertThat().browser().title().contains("SHAFT_Engine");
    }

    @AfterMethod(alwaysRun = true)
    public void teardown() {
        driver.quit();
    }
}

📖 Complete Quick Start Guide → — includes TestNG, JUnit 5, and Cucumber examples.

---

✨ Key Features

The 3 Pillars of Successful Test Automation

📈 Scalability	🎯 Reliability	🔧 Maintainability
CI/CD Integration	Auto-Synchronization	Fluent Design
Cloud Execution	Rich Reporting	Smart Locators
Parallel Testing	Video Recording	AI Validations
Containerization	Screenshot Capture	Zero Boilerplate

Platform Support

Category	Supported
Browsers	Chrome, Edge, Firefox, Safari (Desktop & Mobile)
Mobile Apps	Native, Hybrid, Flutter (Android & iOS)
APIs	REST (GET, POST, PUT, PATCH, DELETE) with full response validation
Databases	MySQL, SQL Server, PostgreSQL, Oracle, IBM DB2, H2, MongoDB
Other	CLI / Terminal, File Assertions (JSON, YAML, Excel, PDF, CSV)
Test Runners	TestNG, JUnit 5, Cucumber BDD

📖 Complete Feature List → · Tech Stack → · Architecture →

---

🌍 Success Partners

💎 Sponsors

         

🏢 Trusted By Leading Organizations

           

View all partners →

---

📚 Documentation

Resource	Description
📖 User Guide	Comprehensive documentation, tutorials, and configuration reference
🏗️ Architecture	Framework design, module overview, and Mermaid diagrams
🛠️ Tech Stack	Technologies and libraries powering SHAFT
✨ Features	Full feature list with platform compatibility matrix
📊 User Analytics	Global adoption, geographic breakdown, and growth metrics

🤖 AI-Powered Code Exploration

Explore SHAFT Engine on Google Code Wiki →

Browse, search, and understand the SHAFT Engine codebase using Google Code Wiki — Google's AI-powered code exploration tool. Ask questions about the code, navigate complex implementations, and get intelligent explanations of framework internals.

---

🤝 Community & Support

Join Our Community

    

Contributing

We love contributions from the community! Here's how you can get involved:

• 🐛 Report a bug — found something broken? Let us know
• 💡 Request a feature — have an idea? We'd love to hear it
• 🔀 Submit a pull request — jump right in and help build SHAFT

Read our Contributing Guidelines and Code of Conduct to get started.

⭐ Show Your Support

If SHAFT has saved you time or helped your team ship faster, please consider giving us a star. It helps others discover the project and motivates the team to keep improving it.

---

💖 Sponsor

SHAFT Engine is free and open source, built with love by a dedicated community. If you or your organization benefit from SHAFT, consider sponsoring the project to help ensure its long-term sustainability.

---

📜 License

SHAFT Engine is released under the MIT License — free to use, modify, and distribute in personal and commercial projects.

---

Stop Reinventing the Wheel. Start Using SHAFT.

Made with ❤️ by the SHAFT community

⬆ Back to Top