Selenium Boot Starter

A ready-to-run Selenium Boot project: Maven or Gradle, TestNG, one config file, a page object, and two passing tests. Click Use this template, clone, run.

Run it

./mvnw test       # Maven  → report: target/selenium-boot-report.html
./gradlew test    # Gradle → report: build/selenium-boot-report/selenium-boot-report.html

Needs Java 17+ and Chrome (or Firefox). No driver setup — Selenium Manager handles it. Pick one build tool and delete the other's files (pom.xml / mvnw / mvnw.cmd / .mvn/, or build.gradle / settings.gradle / gradlew* / gradle/).

What's here

├── pom.xml                       # Maven: one dependency, selenium-boot
├── mvnw, mvnw.cmd, .mvn/         # Maven wrapper (mvnw)
├── build.gradle, settings.gradle # Gradle: same, with the wrapper (gradlew)
├── selenium-boot.yml             # browser, baseUrl, retry, timeouts — all optional
├── testng.xml                    # suite: runs everything in com.example.tests
└── src/test/java/com/example/
    ├── pages/ExamplePage.java    # page object: role-based locators, no CSS/XPath
    └── tests/SmokeTest.java      # a role-locator test and a page-object test

Make it yours

1. Set execution.baseUrl in selenium-boot.yml to your app.
2. Replace ExamplePage and SmokeTest with your own pages and tests.
3. Rename the com.example package and the group id in your build file.

Switch browsers with browser.name: firefox in selenium-boot.yml, or set headless: false to watch it run.

Learn more

• Getting started
• Configuration reference
• BasePage guide

Apache-2.0.