TestBro Documentation

TestBro is an AI-powered browser testing tool that generates and runs automated Playwright tests from plain English descriptions. Stop writing brittle selectors by hand -- describe what you want to test and let AI handle the rest.

Key Features

Plain English Test Descriptions -- Write tests in natural language instead of code. TestBro translates your intent into Playwright actions automatically.
AI Vision Testing -- Uses GPT-4o-mini vision to locate elements on the page, making tests resilient to UI changes.
Selector Learning -- When AI finds elements, it learns the underlying selectors for faster future runs.
Test Case Generation -- Generate comprehensive test suites from PRDs, acceptance criteria, or feature descriptions.
Three Execution Modes -- Choose between speed (selectors), flexibility (AI), or the best of both (hybrid).
Built on Playwright -- All the reliability and cross-browser support of Playwright, without the boilerplate.

Execution Modes

TestBro supports three execution modes to fit different testing needs:

Mode	Speed	Flexibility	Best For
Selector	Fast	Requires stable selectors	Regression testing on stable UIs
AI	Slower	Adapts to UI changes	New features, dynamic interfaces
Hybrid	Balanced	Selectors first, AI fallback	Recommended for most use cases

Quick Links

Quickstart Guide -- Get up and running in 5 minutes
Installation -- Detailed setup instructions
CLI Reference -- Complete command documentation
Execution Modes -- Deep dive into how each mode works
CI/CD Integration -- Run TestBro in your CI pipeline

How It Works

Describe -- Write what you want to test in plain English, or provide a PRD/acceptance criteria file.
Generate -- TestBro uses AI to generate structured test cases with steps, targets, and assertions.
Execute -- Tests run in a real browser using Playwright, with AI vision or learned selectors to find elements.
Report -- Get clear pass/fail results with details on what happened at each step.