SeAuto is a bridge to Selenium from your favorite test framework.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



SeAuto is the necessary “merge between” testing automation frameworks and Selenium. It is the last piece required to start developing automated tests—the glue between the test framework and Selenium. This solution allows good practices to be used from the start—such as using Page Object, Selenium's Page Factory, and an intermediate steps layer to create reusable pieces of code. These ideas have been developed, read, and used over the past several years.

What does this framework provide?

  • Run against any of the major browsers: Firefox, Internet Explorer, Chrome, PhanomJs, and HTMLUnit
  • Run on Linux, Windows, and possibly Mac
  • Run tests on a pre-existing Selenium Grid by simply defining a URL
  • Change a single property to multi-thread tests with assurance tests will be thread safe
  • Clean, clear distinction between the roles of Page Object and intermediate Step Objects.
  • Quickly and easily add Page and Step Objects
  • Useful helper methods for WebDriver that work across all of the browsers, such as accepting a javascript alert (even for the headless browsers!)
  • Easily integrate it as part of your existing CI server
  • Support for a unique browser per test to utilize resources more efficiently
  • Drop-in, ready to start creating tests

Get Started

The easiest way to get started with SeAuto is by using one of the sample project templates. Simply run this one command, select your favorite test automation framework, fill in group/artifact info, and then run the tests! Be sure to have Apache Maven and Firefox installed before creating the sample projects and running the tests.

mvn archetype:generate -Dfilter=seauto

To run the tests, change your directory into the newly created sample project and run

mvn clean integration-test

For more information, take a look at the individual projects:


This parent project contains the projects for:

  • SeAuto core
  • JBehave support
  • JUnit support
  • Cucumber support
  • Selenium driver management

The change log summarizes important differences between versions.


To build this project, clone the git repository and run:

mvn clean install

This will build and test the packages, and install them into the local repository.

Getting Help

Join SeAuto at Google Groups to get help and keep up with SeAuto news!

Or, tag your questions with seauto on StackOverflow.


Please see the documentation.

How To Contribute

Contributions are welcome. Feel free to file issues in Github, or clone the repository, make your changes, and send us a pull request.

Contribution code formatting

Please follow the example of existing code. As long as spaces are used rather than tabs, most other sins can be forgiven. Any questions can be directed to the Google user group.