Skip to main content

Serenity BDD User Manual

Automated Acceptance Testing With Style

Serenity BDD Training

Effective Web Test Automation With Serenity BDD And Selenium

Learn how to write high quality, easy to maintain test automation for your web applications with 50% less code using Serenity BDD.

Learn More

The Test Automation Mastery Archives

Hone your Serenity BDD and Automation skills with over 500 hours of expert-led live coding recordings on real-world problems (40% discount, only $21 per month).

Learn More

Built for AI-assisted testing

AI coding assistants write Serenity tests quickly, and often get the packages and APIs wrong. Serenity BDD now ships current, verified guidance for them, so the tests they write compile, run and make good living documentation.

A skill and a review agent for Claude Code

Ask for a Serenity test and the assistant picks the style you use, or asks you which one you want: Page Objects, Screenplay or Cucumber, with Selenium, Playwright or REST. A read-only review agent then checks that the new tests read as business-level living documentation.

Works with any assistant

Point your assistant at llms.txt, or copy an AGENTS.md for your style into your project so it stays in that style. The documentation pages are also available as plain markdown.

Checked, not guessed

The class and method names in the guidance are checked against the released jars, and the examples are compiled and run on every release. Assistants read test results from the JSON files Serenity writes, not by scraping the HTML report.

Install the plugin in Claude Code:

/plugin marketplace add serenity-bdd/serenity-ai
/plugin install serenity-bdd@serenity

Bring Your Team Together

Don't be a lonely tester writing scripts in a corner, create test automation frameworks that your whole team enjoys using.

Automate At Scale

Write clean, high quality, easily maintained automation code that scales with your test suite, so that you spend your time writing new scenarios, not fixing existing ones.

Report What Really Matters

Serenity BDD provides powerful living documentation and test reporting that gives meaningful feedback to testers, business folks, and the team as a whole. Serenity tells you not only what tests have been executed, but more importantly, what requirements have been tested.

Test UI, API and Mobile

Serenity supports both UI and API testing, and integrates seamlessly with standard industry tools such as Selenium 4 and RestAssured.

Integrate with your favorite test automation libraries

Automate executable specifications with BDD tools like Cucumber, or write clean and maintainable test code with business-readable reporting in JUnit 4 or 5.

Apply Best Practices

Use conventional Page Objects, and reduce the amount of code needed by 50% compared to traditional page object implementations, or try out more modern test automation design patterns such as Action Classes or the Screenplay Pattern, and write scalable, easy to maintain code tailor-fitted to your domain.

Platinum Sponsors

Give your users a seamless experience by testing on 3000+ real devices and browsers. Don't compromise with emulators and simulators.

Perform Automated and Live Interactive Cross Browser Testing on 3000+ Real Browsers and Operating Systems Online.

Start Learning Real-World Test Automation Today with a proven programme that will set you apart from your peers.