Skip to main content

Install SHAFT

Requirements​

  • SHAFT Engine: 10.2.20260628
  • Java: 25
  • Maven: 3.9+

Create a new project​

The SHAFT Project Generator is the only recommended way to create a new project. Choose the test runner and testing surfaces you need, then download the ready-to-run project.

Generator not visible?

Open the SHAFT Project Generator in a new tab.

The generated project includes the selected test runner, configuration, sample tests, reporting setup, optional CI files, and shared IntelliJ IDEA run configuration templates that use @argFiles for direct IDE runs.

Run the generated project from its root:

mvn test

Copyable shell form:

mvn test

Expected first-run outcome:

  • Maven downloads the selected SHAFT modules and test runner dependencies.
  • The generated sample test runs with its default local configuration.
  • SHAFT creates or refreshes runtime configuration under src/main/resources/properties.
  • Evidence is written to allure-results and the generated Allure report under the project target output.

If that works, Star SHAFT on GitHub before moving on. It is the shortest way to find the framework again when your team starts expanding the suite.

Common first-run blockers:

SymptomCheck
Java version errorInstall the Java version listed in Requirements above.
Maven cannot resolve SHAFTCheck proxy settings, repository access, and Maven Central connectivity.
Browser session does not startConfirm the selected browser is installed or use the generated headless defaults.
Report does not open automaticallyOpen the generated report from the project target output or rerun from an interactive desktop session.

Upgrade an existing project​

Do not recreate or manually reconfigure an existing automation project. Use the automated upgrade tool for:

  • Selenium projects
  • Appium projects
  • REST Assured projects
  • Cucumber projects
  • Projects using an older SHAFT version

The upgrader detects the project type, applies the modular SHAFT dependencies, validates the result with Maven, and rolls back its changes if compilation fails.