Projects

Projects are the top-level containers in ProvaLab.io. Every test case, suite, plan, and run belongs to a project. This guide covers everything you need to know about working with projects.

Create a Project

1. Click Projects in the left sidebar.
2. Click + New Project.
3. Fill in the project details:
   • Name -- A clear, descriptive name (e.g., "Mobile Banking App" or "Website Redesign Q1").
   • Project Key -- A short identifier auto-generated from the name. You can edit it. This key prefixes all test case IDs (e.g., MBA-TC-001).
   • Description -- A summary of what the project covers.
4. Click Create Project.

tip

Use a consistent naming convention across your organization. For example: "Product Name - Component" (e.g., "Acme App - Payments"). This makes it easy to find projects as your list grows.

The Project Dashboard

When you open a project, the dashboard shows metrics specific to that project:

• Total test cases and their status breakdown (Draft, Approved, Deprecated).
• Active test runs and their progress.
• Pass rate trends over time.
• Recent activity from team members.

Manage Team Members

Invite New Members

1. Open your project.
2. Go to Settings > Members.
3. Click Invite Member.
4. Enter the person's email address.
5. Select a role from the dropdown.
6. Click Send Invitation.

The person receives an email invitation. If they already have a ProvaLab.io account, the project appears in their project list immediately.

Roles and Permissions

Role	What they can do
Owner	Full control, including deleting the project and managing billing.
Admin	Manage members and settings. Cannot delete the project.
QA Manager	Create test plans, assign runs, generate reports.
QA Engineer	Create and edit test cases, execute runs, log defects.
Developer	View test cases and results, add comments.
Viewer	Read-only access to everything in the project.

Change a Member's Role

1. Go to Settings > Members.
2. Find the team member in the list.
3. Click the role dropdown next to their name.
4. Select the new role.
5. Click Save.

Remove a Member

1. Go to Settings > Members.
2. Find the team member.
3. Click the remove icon (trash) next to their name.
4. Confirm the removal.

info

Removing a member does not delete their work. All test cases, results, and comments they created remain in the project.

Project Settings

Open your project and go to Settings to configure:

Setting	Description
General	Update project name, key, description, and status.
Default Environment	Set the default environment for new test runs (e.g., Staging, QA).
Notifications	Control which project events trigger notifications.
CI Integration	Enable automatic test run triggers from your CI/CD pipeline.
Custom Fields	Add custom metadata fields to test cases (e.g., "Sprint", "Browser").

Archive a Project

When a project is no longer active but you want to keep its data:

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

Archived projects:

• Are hidden from the main project list.
• Can be found by toggling Show Archived in the projects filter.
• Can be restored at any time with all data intact.
• Do not count toward your plan's project limit.

Delete a Project

If you need to permanently remove a project:

1. Open the project's Settings.
2. Scroll to Danger Zone.
3. Click Delete Project.
4. Type the project name to confirm.
5. Click Delete Permanently.

info

Deleting a project is permanent and cannot be undone. All test cases, runs, results, and reports in the project are permanently removed. Consider archiving instead.