SynthQA

Projects Guide

Organize your testing work with projects. Group test cases, requirements, suites, and templates for better structure and visibility.

Guide
Getting started

Overview

What are Projects?
Organizational containers that group related testing work together.
  • Group test cases, requirements, suites, and templates
  • Filter and view work by project across the platform
  • Track project-level statistics and progress
  • Customize with colors and icons for visual identification
  • Manage project lifecycle from planning to completion
  • Archive old projects while preserving historical data
Key benefits
Why use projects to organize your work?
Clarity
See all work related to a specific product or feature
Filtering
Quickly filter views to show only one project's items
Context
Understand what each test case or requirement belongs to
Reporting
Generate project-specific reports and metrics
Step-by-step

Creating Projects

Visual identity

Customization

Colors and icons
Personalize projects for quick visual identification.
Available icons:
Folder
General projects
Smartphone
Mobile apps
Code
Development projects
Shield
Security projects
Globe
Web applications
Database
Backend/data projects
Cloud
Cloud infrastructure
Rocket
Launch/release projects
Package
Product releases
Terminal
CLI/dev tools
Color palette:
Blue
General purpose
Green
Active development
Purple
Planning phase
Orange
In progress
Red
Critical/urgent
Pink
Design/UX
Indigo
Research
Yellow
Testing phase
Gray
On hold
Color coding strategies
How to use colors effectively across your projects.
🟢 Green = Active development
🔵 Blue = Planning phase
🟡 Yellow = Testing in progress
🟣 Purple = Awaiting release
⚪ Gray = On hold

Using projects

Organization

Assigning items to projects
How to link test cases, requirements, suites, and templates to projects.
Test Cases
• During test case creation
• When editing test cases
• Via bulk update operations
Requirements
• During requirement creation
• When editing requirements
• Automatically links to generated test cases
Test Suites
• During suite creation
• When editing suite details
• Optional assignment
Templates
• Coming soon
• Will support project assignment
• For project-specific settings

Status management

Project Lifecycle

Project statuses
Track project progress through different phases.
Active
Currently being worked on
On Hold
Temporarily paused
Completed
Finished and delivered
Archived
No longer active, hidden from main view

Metrics & insights

Project Dashboard

What's on the project dashboard?
Each project has a dedicated dashboard showing execution metrics, trends, and problem tests.

Click any project to open its dashboard. You'll see a live snapshot of everything happening across manual and automated test runs for that project.

  • KPI cards for total executions, pass rate, failures, and artifact counts
  • Execution trend chart covering the last 30 days — both manual and automation runs
  • Top problem tests ranked by failure count and flakiness score
  • Test suites summary with pass rates and last run dates
  • Quick links to requirements, test cases, and failed tests
KPI cards
Four summary cards give you an at-a-glance health check for the project.
Executions

Total test executions in the last 30 days — combines manual runs, automated test executions, and automation suite runs. Shows combined pass rate and average duration. Automation run count appears as a violet annotation when automation data is present.

Passed

Total passing executions. Shows failed count in the subtitle. If automation runs are present, a violet "Auto: X/Y" note shows automation pass rate separately.

Blocked / Skipped

Combined blocked and skipped executions. Broken down individually in the subtitle.

Artifacts

Counts of test suites, total test cases, requirements, and templates attached to this project.

Execution trend chart
A 30-day line chart showing pass and fail counts over time.

The chart plots four lines:

Manual passed — solid green line
Manual failed — solid red line
Auto passed — dashed green line
Auto failed — dashed red line
Top problem tests
Tests ranked by failure frequency to help you focus on what matters most.

The problem tests panel surfaces the most frequently failing tests from the last 30 days. It covers three sources:

Regular test cases

Manual and automated executions linked to your standard test cases. Shows failure count, priority badge, and flakiness percentage.

Platform test cases

Cross-platform tests (Web, Mobile, API, Accessibility) that are failing. Same failure count and flakiness metrics.

automation
Automation suite runs

Suite-level failures from the Automation Hub where individual test breakdowns aren't available. Shown with a violet "automation" badge and link to the Automation Hub. Displays the suite name, framework, and branch alongside failed test count.

Test suites summary
A quick view of the project's test suites with pass rates and last run dates.

The dashboard shows the five most recent suites. Each entry shows the suite name, test case count, pass rate, and when it was last run. Click "View All" to open the full Test Library filtered to this project.

Finding projects

Filtering & Search

Quality

Best Practices

Effective project organization
Strategies for structuring your projects.
✅ Do
  • Create projects for distinct products/features
  • Use clear, descriptive names
  • Choose consistent color/icon schemes
  • Archive completed projects regularly
  • Update status as projects progress
  • Add meaningful descriptions
❌ Avoid
  • Too many small, granular projects
  • Generic names like "Project 1"
  • Random color choices without system
  • Leaving all projects as "Active" forever
  • Creating projects for temporary work
  • Forgetting to archive old projects
Project structure patterns
Common ways to organize projects.

One project per product or application:

• Mobile App iOS
• Mobile App Android
• Web Application
• Admin Dashboard
• Public API

Best for: Teams with multiple distinct products

When to create a project
Deciding if you need a new project.
Create a project when:
  • Testing a new product or major feature that will have ongoing work
  • Starting a distinct testing initiative (e.g., security audit)
  • Managing work that spans multiple sprints or releases
  • Needing to separate reporting and metrics by product/area
Don't create a project when:
  • Testing a small bug fix or minor feature (use existing project)
  • Work is temporary or one-time (doesn't need long-term organization)
  • You're just starting and have only a few test cases
  • The work fits well within an existing project
Maintenance schedule
Keep your projects organized over time.
Regular maintenance:
  • Monthly: Review project statuses, update to reflect current state
  • Quarterly: Archive completed projects, review if all projects are still needed
  • After releases: Mark projects as completed or archived
  • As needed: Update descriptions when project scope changes
FAQ

Frequently Asked Questions

Help

Support

Getting help
Resources for project management assistance.
Contact options:
  • Email: support@synthqa.app
  • Use the feedback button in your dashboard
  • Visit our knowledge base for examples
When requesting project support:
  • Describe your team structure and testing needs
  • Share your current project organization challenges
  • Explain what you're trying to achieve
  • Include screenshots if reporting UI issues
Last updated: January 2026 · Guide version: 1.0