auto_fix_highTestBro

Projects

Projects are the top-level organizational unit in TestBro. Each project contains a collection of test cases and test runs tied to a specific application or feature area.

Creating a Project

From the CLI

testbro projects create

This starts an interactive prompt asking for a project name and optional description.

From the Dashboard

  1. Log in to the TestBro dashboard
  2. Click New Project
  3. Enter a name and optional description
  4. Click Create

Via the API

curl -X POST https://your-instance.com/api/projects \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App", "description": "Tests for the main application"}'

Listing Projects

View all your projects:

testbro projects

This displays a table with project IDs, names, test case counts, and which project is currently active.

Active Project

The active project is used as the default when running commands that require a project ID. Set it with:

testbro use-project <project-id>

Clear the active project:

testbro use-project --clear

Check which project is active:

testbro whoami

When a project is active, you can omit the --project flag from commands:

# Instead of:
testbro run --url https://example.com --project abc123 --mode ai

# You can just run:
testbro run --url https://example.com --mode ai

Project Configuration

Each repository can have a test-bro.config.json that binds to a specific project:

{
  "projectId": "your-project-id",
  "baseUrl": "https://your-app.com",
  "mode": "hybrid",
  "timeout": 30000
}

When this file is present, the CLI uses its projectId and baseUrl automatically. The --project flag and --url flag override the config file values.

Managing Test Cases

Each project holds its own set of test cases. You can:

  • View test cases in the dashboard project detail page
  • Generate test cases with testbro generate --project <id>
  • Run all test cases with testbro run --project <id>
  • Bulk create test cases via the API

Test Runs

Every time you execute tests against a project, a test run is created. Runs track:

  • Which test cases were executed
  • Pass/fail status for each step
  • Execution mode used
  • Timestamps and duration

View run results in the dashboard or via the API.

Next Steps