Your First Project

Projects are the top-level containers in ProvaLab.io. Everything -- test cases, suites, plans, runs, and reports -- lives inside a project. This guide walks you through creating your first one.

Create a New Project

1. Click Projects in the left sidebar.
2. Click the + New Project button.
3. Fill in the project details:
   • Name -- A descriptive name for your project (e.g., "E-Commerce Platform" or "Mobile App v3").
   • Project Key -- A short, URL-friendly identifier that is auto-generated from the name (e.g., "ECOM"). You can customize it. This key is used in test case IDs like ECOM-TC-001.
   • Description -- A brief summary of what the project covers and what you are testing.
4. Click Create Project.

You will be taken to your new project's dashboard.

tip

Choose a project key that is short and memorable. Your team will use it frequently when searching and referencing test cases.

Invite Team Members

A project is better with your team. Here is how to add people:

1. Open your project and go to the Settings tab (or click Add Members).
2. Click Invite Member.
3. Enter the person's email address.
4. Select their role from the dropdown.
5. Click Add.

The invited person will receive an email invitation. If they already have a ProvaLab.io account, they will see the project immediately. If not, the invitation guides them through account creation.

Team Roles

Each role determines what a team member can do within the project:

Role	Permissions
Owner	Full control. Can delete the project, manage billing, and do everything below.
Admin	Manage team members, configure project settings, and do everything below.
QA Manager	Create and manage test plans, assign test runs, generate reports, and do everything below.
QA Engineer	Create and edit test cases, execute test runs, log defects, and do everything below.
Developer	View test cases and results, add comments, and do everything below.
Viewer	Read-only access. Can view test cases, results, and reports but cannot make changes.

info

You can change a team member's role at any time from the project's Settings > Members page. Only Owners and Admins can manage roles.

Configure Project Settings

After creating your project, you may want to adjust a few settings:

1. Open your project.
2. Click Settings in the project navigation.
3. Configure the available options:

Setting	What it does
Default Environment	Set the default test environment (e.g., Staging, QA, Production) for new test runs.
Notifications	Choose which project events trigger notifications for the team.
CI Integration	Enable automatic test run creation from your CI/CD pipeline.
Custom Fields	Add custom fields to test cases (e.g., "Browser", "Device", "Sprint").

4. Click Save Settings.

tip

You do not need to configure everything upfront. The defaults work well for most teams. You can always come back and adjust settings as your workflow evolves.

Understand the Project Dashboard

Once your project is created, the project dashboard gives you a quick overview:

• Quick Stats -- Total test cases, active test runs, overall pass rate, and recent failures.
• Recent Test Runs -- Your latest test executions with progress bars and pass/fail counts.
• Test Health -- A breakdown of healthy, flaky, and failing tests.
• Activity Feed -- Recent actions by your team: test cases created, runs completed, comments added.

Archive a Project

When a project is no longer active, you can archive it instead of deleting it:

1. Open the project's Settings.
2. Scroll to the Danger Zone section.
3. Click Archive Project.
4. Confirm the action.

Archived projects are hidden from the main list but can be restored at any time. All data is preserved.

Next Steps

Your project is ready. Now it is time to create and run your first test.