
Selenium Boot
Java testing framework that brings Spring Boot conventions and Playwright APIs to Selenium
Gallery
About Selenium Boot
Selenium Boot is a Java testing framework that simplifies browser automation by wrapping Selenium WebDriver with sensible defaults and modern APIs inspired by Playwright. The pitch is that you get enterprise grade automation without hiding Selenium underneath, so you keep the full power of the ecosystem while writing less boilerplate and fighting fewer timing bugs.
The biggest pain point it addresses is waiting. Anyone who has written Selenium tests knows the dance of Thread.sleep calls, explicit waits, and flaky assertions that pass locally but fail in CI. Selenium Boot centralizes all of that in a WaitEngine that auto waits before every action. You call a method, it waits until the element is ready, then acts. No manual sleep calls, no scattered WebDriverWait blocks.
Locators get the same treatment. Instead of chaining CSS selectors and XPaths that break every time the frontend team refactors a class name, Selenium Boot promotes accessibility first locators like getByRole, getByLabel, and getByText. These survive CSS refactors because they anchor to semantic attributes the user actually sees, not implementation details.
Assertions follow a web first model borrowed from Playwright. Instead of asserting immediately and failing if the condition isn't true yet, assertions auto retry until a timeout. If you're checking that a button becomes enabled after an AJAX call, the test waits for that state rather than throwing instantly. This one change eliminates a category of flakiness that plagues traditional Selenium suites.
On the reporting side, Selenium Boot generates HTML and JUnit XML reports out of the box. The HTML report includes a tabbed dashboard with test results, screenshots on failure, and step logs. CI systems like GitHub Actions, Jenkins, and GitLab are detected automatically, so environment variables and artifact paths just work without extra configuration.
For teams running tests in parallel, driver management is thread safe by default. You don't have to worry about one test closing the browser while another test is still using it. There's also global and per method retry logic for tests that are flaky due to external dependencies, with configurable retry counts.
Selenium Boot is free and open source under Apache 2.0. It targets Java teams that want to stay in the Selenium ecosystem but reduce the maintenance overhead of custom wait utilities, base classes, and reporting scripts. If you're starting a new automation project or inheriting a brittle test suite and looking for a path that doesn't require a full rewrite, this sits in a useful middle ground.
Key Features
- Auto waiting actions via centralized WaitEngine
- Accessibility first locators (getByRole, getByLabel, getByText)
- Web first assertions that auto retry until timeout
- Built in HTML and JUnit XML reporting
- Thread safe driver management for parallel tests
- Automatic CI detection for GitHub, Jenkins, GitLab
Pros & Cons
What we like
- Eliminates manual Thread.sleep and explicit wait boilerplate
- Locators survive CSS refactors by anchoring to semantic attributes
- Auto retry assertions cut flaky test failures significantly
- Free and open source under Apache 2.0
Room for improvement
- Java only, not useful for Python or JavaScript test suites
- Newer project with a smaller community than raw Selenium or Playwright
- Learning curve if your team is used to raw WebDriver patterns
- Documentation is still maturing
Frequently Asked Questions
What is Selenium Boot?
Is Selenium Boot free?
Does Selenium Boot replace Selenium?
Who is Selenium Boot for?
Best For
Featured in
Alternatives to Selenium Boot
View allPlaywright
Microsofts open-source end-to-end browser testing framework for Chromium, Firefox, and WebKit with one API.

Buildkite
Hybrid CI/CD where the control plane is hosted but the build agents run on your own infrastructure.
Storybook
Open-source workshop for building UI components in isolation. Preview, document, and test them outside the app.

Postman
API client and collaboration platform that started as a Chrome extension and now covers design, testing, and mocking.
Reviews (8)
Recommended without reservation
Found Selenium Boot on a Show HN thread and I am glad I clicked. Where it really wins is free and open source under apache 2.0. The interface stays out of my way, which I appreciate. No regrets so far.
Pulled its weight from week one
Tried Selenium Boot on a side project first, then rolled it out everywhere. Where it really wins is automatic ci detection for github, jenkins, gitlab. The thing I keep coming back to is how reliable it is. Glad I made the switch.
Worth a look
Picked Selenium Boot for the price, stayed for the quality. Support actually answered when I had a question, which surprised me. It fits well for generating ci friendly reports without custom scripting. Recommending it to people in a similar spot.
Finally something that fits
Found Selenium Boot on a Show HN thread and I am glad I clicked. Their take on auto retry assertions cut flaky test failures significantly is genuinely good. The thing I keep coming back to is how reliable it is. Mostly using it for reducing flakiness in an existing selenium test suite.
Recommended without reservation
Three months of Selenium Boot later, here is what holds up. Where it really wins is auto retry assertions cut flaky test failures significantly. Found it works best for generating ci friendly reports without custom scripting.
Worth a look
Three months of Selenium Boot later, here is what holds up. Got real value out of locators survive css refactors by anchoring to semantic attributes. Recommending it to people in a similar spot.
Pulled its weight from week one
Selenium Boot solves a real problem for me without making a fuss about it. What stands out is how it handles locators survive css refactors by anchoring to semantic attributes. It slotted into my routine without much fuss. Glad I made the switch.
It just works
Hadn't planned on switching, but Selenium Boot was hard to ignore. Where it really wins is auto waiting actions via centralized waitengine. The interface stays out of my way, which I appreciate. Mostly using it for generating ci friendly reports without custom scripting. It earns its place in my stack.
Related Tools

Chromatic
Visual regression testing and review platform built by the Storybook team, with cloud-rendered snapshots and PR integration.
Playwright
Microsofts open-source end-to-end browser testing framework for Chromium, Firefox, and WebKit with one API.

AgentsProof
Trace, grade and share proof that your AI agent actually works

CircleCI
Hosted continuous integration that runs your test suite in parallel containers across Linux, macOS, Windows, and ARM.