Create Your First Project
Projects help you organize your tests by application or feature area. Let’s create your first project!
What is a Project?
A project in BugBrain represents a web application or website you want to test. Each project can contain:
- Test Cases - Individual test scenarios
- Test Plans - Groups of tests to run together
- Executions - Test run results and history
- Personas - User accounts for authenticated testing
- Integrations - Connections to Slack, Jira, etc.
Creating a Project
1
Go to the Dashboard
After logging in, you'll land on the dashboard. Click the 'Projects' link in the sidebar.
2
Click 'New Project'
Click the 'New Project' button in the top right corner of the Projects page.
3
Enter Project Details
Fill in the project information: Name (e.g., 'My Website'), Description (optional), and Base URL (the main URL of your app, e.g., 'https://example.com').
4
Choose Settings (Optional)
Configure default settings like execution timeout, browser type, and screenshot capture options. You can change these later.
5
Click 'Create Project'
Save your project. You'll be redirected to the project overview page.
Project Settings Explained
When creating a project, you can configure:
| Setting | Description | Default |
|---|---|---|
| Name | Project display name | Required |
| Description | Optional project description | Empty |
| Base URL | Main application URL | Required |
| Environment | production, staging, development | production |
| Browser | chrome, firefox, safari | chrome |
| Timeout | Max execution time (seconds) | 300 |
| Screenshots | Capture screenshots during tests | Enabled |
Pro Tip: Use descriptive project names like “Main Website - Production” or “Admin Panel - Staging” to easily identify projects.
What’s Next?
Now that you have a project, you can:
Managing Projects
Editing Projects
To edit a project:
- Go to the Projects page
- Click the project you want to edit
- Click the ‘Settings’ tab
- Update any settings
- Click ‘Save Changes’
Deleting Projects
🚫
Warning: Deleting a project is permanent and will delete all test cases, executions, and related data. This cannot be undone!
To delete a project:
- Go to Project Settings
- Scroll to the bottom
- Click ‘Delete Project’
- Confirm deletion by typing the project name