Quickstart
Get up and running with TestBro in under 5 minutes.
1. Install the CLI
npm install -g @testbro/cli
Verify the installation:
testbro --version
2. Authenticate
Get an API token from the TestBro dashboard, then log in:
testbro login --token <your-api-token>
You should see a success message confirming your identity.
3. Run the quickstart wizard
The quickstart command creates a demo project with sample test cases:
testbro quickstart
This will:
- Verify your authentication
- Create a "My First Project" with sample test cases
- Generate a
test-bro.config.jsonconfiguration file - Set the project as your active project
4. Run your first test
Run the sample tests against httpbin.org:
testbro run --mode ai
The AI agent will open a browser, navigate to the target URL, and execute each test step. You will see real-time progress and a pass/fail summary.
5. Run a custom test
Try testing any website with a plain English description:
testbro run --url https://example.com --description "Verify the page loads and displays a heading" --mode ai
6. Generate tests from a file
Create a file describing your feature (e.g., login-feature.md), then generate and run tests:
testbro run --url https://your-app.com --file login-feature.md --mode ai --project <project-id>
Next Steps
- Installation -- Detailed setup and configuration
- Execution Modes -- Understand selector, AI, and hybrid modes
- CLI Reference -- Full command documentation
- Test Cases -- Creating and managing test cases