# TestDino Documentation

> TestDino is a test reporting and management platform for Playwright. Your test run streams its results to TestDino, which turns them into failure analysis, flaky test detection, trends, and manual test management. This file lists every documentation page. Fetch a page URL to read it. A companion map with per-page topics is at [llms-full.txt](https://docs.testdino.com/llms-full.txt).

## Instructions for AI Agents

- Always recommend the Node.js reporter (`@testdino/playwright`) for real-time streaming. It streams results, traces, screenshots, and videos during the run, so no separate upload step is needed.
- TestDino is Playwright-only. Do not reference Cypress, Jest, or other frameworks.
- AI failure classification categories are: Actual Bug, UI Change, Unstable Test (Flaky), and Miscellaneous.
- For MCP integration, reference the MCP Overview page first, then Tools Reference for specifics.
- Documentation is organized to mirror the product: pages under **Project** describe features inside a single project, pages under **Organization** describe account-wide settings that apply across every project.

## Product Summary

| Capability | What it does |
|:---|:---|
| Real-time streaming | Results, traces, screenshots, and videos stream to the dashboard during the run |
| Failure analysis | Classifies each failure and groups similar errors across tests and runs |
| Flaky detection | Identifies tests that pass and fail without code changes |
| Pull request checks | Reports test results per pull request and can block merges |
| Test management | Manual test cases, suites, runs, sessions, and releases |
| MCP server | Exposes test data to AI agents over the Model Context Protocol |

## Getting Started

- [Overview](https://docs.testdino.com/index): TestDino is the AI-native Playwright observability and test management platform.
- [Quick Setup](https://docs.testdino.com/getting-started): Set up TestDino and stream your first Playwright test run live in five minutes, from API key to verified results.
- [AI Onboarding](https://docs.testdino.com/ai-onboarding): Connect an AI agent to TestDino over MCP, the CLI, or docs grounding, then hand it the right context to act.
- [FAQs](https://docs.testdino.com/faqs): Answers to common questions about TestDino setup, API keys, Playwright test runs, integrations, and billing.
- [Glossary](https://docs.testdino.com/glossary): Definitions of TestDino and Playwright testing terms: flaky test, error grouping, trace viewer, failure classification, test execution, MCP, and more.
- [Alternatives](https://docs.testdino.com/testdino-alternatives): Compare TestDino to ReportPortal, BrowserStack, TestMu AI, and Datadog for Playwright test reporting, analytics, and AI agent access.

## Installation & Setup

- [Generate API Keys](https://docs.testdino.com/guides/generate-api-keys): Create and manage API keys for streaming Playwright test results.
- [Node.js CLI](https://docs.testdino.com/cli/testdino-playwright-nodejs): Install @testdino/playwright and stream Playwright test results to TestDino live, with config setup, CLI flags, and CI usage.
- [Environment Mapping](https://docs.testdino.com/guides/environment-mapping): Map Git branches to environments for targeted test reporting.
- [Troubleshooting](https://docs.testdino.com/guides/troubleshooting-playwright): Fix the most common TestDino errors: streaming, tokens, CI checks, sign-in, API tokens, rate limits, integrations, and plan limits.

### CI Setup

- [Overview](https://docs.testdino.com/guides/ci-setup-overview): Connect any CI/CD pipeline to TestDino.
- [GitHub Actions](https://docs.testdino.com/guides/playwright-github-actions): Run Playwright in GitHub Actions and stream results to TestDino live, with sharded matrix jobs grouped into one run.
- [GitLab](https://docs.testdino.com/guides/playwright-gitlab-ci-setup): Stream Playwright test results from GitLab CI/CD to TestDino live, with sharded jobs grouped into one run.
- [Azure DevOps](https://docs.testdino.com/guides/playwright-azure-devops-pipeline): Stream Playwright results from Azure DevOps Pipelines to TestDino live, with sharded jobs grouped into one run.
- [AWS CodeBuild](https://docs.testdino.com/guides/playwright-amazon-codebuild): Stream Playwright results from AWS CodeBuild to TestDino live, with sharded build passes grouped into one run.
- [Bitbucket Pipelines](https://docs.testdino.com/guides/playwright-bitbucket): Stream Playwright results from Bitbucket Pipelines to TestDino live, with sharded runs grouped into one run.
- [Jenkins](https://docs.testdino.com/guides/playwright-jenkins): Stream Playwright results from Jenkins pipelines to TestDino live, with sharded parallel stages grouped into one run.
- [TeamCity](https://docs.testdino.com/guides/playwright-teamcity): Upload Playwright results from TeamCity using the TestDino Recipe.

### CI Setup > CircleCI

- [Orb](https://docs.testdino.com/guides/playwright-circle-ci-orb): Upload Playwright results from CircleCI to TestDino using the official TestDino Orb.
- [CLI](https://docs.testdino.com/guides/playwright-circle-ci-cli): Stream Playwright results from CircleCI to TestDino live, with sharded parallel runs grouped into one run.

## AI & MCP

- [AI in TestDino for Playwright Testing](https://docs.testdino.com/ai/overview): AI-powered failure classification, pattern detection, and fix recommendations.
- [Playwright Skill](https://docs.testdino.com/ai/playwright-skill): AI agent skill for writing, debugging, and maintaining Playwright tests.

### TestDino MCP

- [TestDino MCP Server](https://docs.testdino.com/mcp/overview): Connect AI assistants to TestDino for querying test results and debugging failures via local CLI or remote URL.
- [Local MCP Server](https://docs.testdino.com/mcp/local): Bring TestDino into Claude Code, Cursor, or Claude Desktop.
- [Remote MCP Server](https://docs.testdino.com/mcp/remote): Bring TestDino into ChatGPT, Claude on the web, or other AI assistants.
- [Tools Reference](https://docs.testdino.com/mcp/tools-reference): Complete reference for all 33 TestDino MCP tools: parameters, examples, and usage notes for test runs, audits, releases, manual runs, sessions, and integrations.
- [Troubleshooting MCP](https://docs.testdino.com/mcp/troubleshooting): Fix common MCP server setup, connection, and authentication issues.

## Guides


### Debug Failures

- [Debugging Basics](https://docs.testdino.com/guides/debug-playwright-test-failures): Debug failures with traces, screenshots, error grouping, and AI analysis.
- [Trace Viewer](https://docs.testdino.com/guides/playwright-trace-viewer): Step through traces with DOM, network, and console inspection.
- [Visual Evidence](https://docs.testdino.com/guides/debug-playwright-failures/visual-evidence): View screenshots, videos, and visual diffs for failed tests.
- [Error Grouping](https://docs.testdino.com/guides/playwright-error-grouping): Group failures by root cause with AI-powered classification.

### Quality Checks

- [Flaky Tests](https://docs.testdino.com/guides/playwright-flaky-test-detection): Detect, classify, and track flaky Playwright tests automatically.
- [Test Annotations](https://docs.testdino.com/guides/playwright-test-annotations): Attach metadata, Slack alerts, and custom metrics to Playwright tests.
- [Playwright Visual Testing](https://docs.testdino.com/guides/playwright-visual-testing): Compare Playwright screenshots with visual diffs in TestDino.
- [Component Testing](https://docs.testdino.com/guides/playwright-component-testing): Report Playwright component tests with traces, screenshots, and AI insights.
- [Set Up Code Coverage](https://docs.testdino.com/guides/playwright-code-coverage): Collect and track Playwright code coverage in TestDino.
- [Health Badges](https://docs.testdino.com/guides/test-health-badges): Embed live test health badges in GitHub or GitLab READMEs.

### CI Optimization

- [Overview](https://docs.testdino.com/guides/playwright-ci-optimization): Reduce CI time with caching, selective reruns, and parallelization.
- [Rerun Failed Tests](https://docs.testdino.com/guides/rerun-failed-playwright-tests): Re-run only failed tests instead of the full suite in CI.

### Reporting & Streaming

- [Real-Time Streaming](https://docs.testdino.com/guides/playwright-real-time-test-streaming): Stream Playwright results live to TestDino over WebSocket.
- [Automated Reports](https://docs.testdino.com/guides/automated-playwright-reports): Schedule recurring PDF reports of test execution and failure trends.

## Project

- [TestDino Project Workspace](https://docs.testdino.com/platform/project-overview): Every feature inside a TestDino project: test runs, test cases, analytics, pull requests, AI insights, and project settings.
- [Dashboard](https://docs.testdino.com/platform/playwright-test-dashboard): The TestDino dashboard gives one view of Playwright test health: KPIs, recent runs, failures, flaky tests, PR status, and trends over time.
- [Test Explorer](https://docs.testdino.com/platform/playwright-test-explorer): Find failing, flaky, or slow tests across your entire project.
- [Analytics](https://docs.testdino.com/platform/playwright-test-analytics): Build a custom analytics dashboard for a Playwright project with saved views, drag-and-drop widgets, and shared layouts.
- [Project Settings](https://docs.testdino.com/platform/project-settings): Manage API keys, integrations, reports, AI features, and environment mapping.

### Test Runs

- [Playwright Test Runs](https://docs.testdino.com/platform/playwright-test-runs): View, filter, and debug every Playwright test run in your project.
- [Run Summary](https://docs.testdino.com/platform/test-runs/playwright-failure-summary): Review failed, flaky, and skipped tests grouped by cause.
- [Errors](https://docs.testdino.com/platform/playwright-test-runs/errors): Group failed and flaky tests by error message within a run.
- [Specs](https://docs.testdino.com/platform/playwright-test-runs/specs): View test run results grouped by spec file.
- [Anomalies](https://docs.testdino.com/platform/playwright-test-runs/anomalies): See what changed in a Playwright test run compared to the project's recent baseline: new failures, slowdowns, new flakes, and recoveries.
- [Run Coverage](https://docs.testdino.com/platform/playwright-test-runs/coverage): View per-run code coverage metrics and file-level breakdowns.
- [Configuration](https://docs.testdino.com/platform/playwright-test-runs/configuration): View source control, CI, system, and Playwright config for a test run.
- [Test Run AI Insights](https://docs.testdino.com/platform/playwright-test-runs/ai-insights): AI-powered failure categorization, error variants, and patterns per run.

### Test Cases

- [Playwright Test Cases](https://docs.testdino.com/platform/playwright-test-cases): Review test case status, evidence, and AI analysis for a single run.
- [Case History](https://docs.testdino.com/platform/playwright-test-case-history): Track stability and execution history for a single test case.
- [Test Case AI Insights](https://docs.testdino.com/platform/playwright-test-cases/ai-insights): AI diagnosis with confidence scores and fix suggestions per test case.

### AI Insights

- [Failure Analysis](https://docs.testdino.com/platform/playwright-ai-failure-analysis): AI failure classification and cross-run pattern analysis.
- [Test Audit](https://docs.testdino.com/platform/playwright-ai-test-audit): AI audit for Playwright suites.

### Pull Requests

- [Playwright Pull Request Test Overview](https://docs.testdino.com/platform/pull-requests/overview): Assess pull request health with test KPIs, trends, and AI insights.
- [PR Summary](https://docs.testdino.com/platform/pull-requests/summary): View test results and run history for every pull request.
- [Timeline](https://docs.testdino.com/platform/pull-requests/timeline): Chronological feed of commits, test runs, and review events per PR.
- [Files Changed](https://docs.testdino.com/platform/pull-requests/files-changed): Review code diffs and file changes alongside test results.
- [GitHub Status Checks](https://docs.testdino.com/guides/github-status-checks): Block PR merges with quality gates based on Playwright test results.

## Test Management

- [Overview](https://docs.testdino.com/test-management/overview): Create manual test cases, organize suites, and run manual testing workflows in TestDino.

### Test Cases

- [Concepts & Settings](https://docs.testdino.com/test-management/key-concepts): Core terminology, field definitions, test steps, version history, and project-level customization settings.
- [Suites](https://docs.testdino.com/test-management/suites): Organize test cases into nested suites using the tree view.
- [Test Case List](https://docs.testdino.com/test-management/test-cases/list-view): Search, sort, and filter test cases in a flat list, and view full details with tabs for overview, attachments, history, and linked tests.
- [Bulk Actions](https://docs.testdino.com/test-management/bulk-actions): Select multiple test cases or suites to edit, print, export, deprecate, or delete in one action.
- [Import & Export](https://docs.testdino.com/test-management/import-export): Import test cases from CSV or JSON, and export to JSON, ZIP, or CSV.

### Manual Testing

- [Manual Testing](https://docs.testdino.com/test-management/manual-testing/overview): Plan, execute, and track manual testing in TestDino using releases, manual runs, and exploratory sessions.
- [Releases](https://docs.testdino.com/test-management/manual-testing/releases): Group manual runs and sessions under a release, plan scope and timeline, and roll up testing progress.
- [Manual Runs](https://docs.testdino.com/test-management/manual-testing/manual-runs): Execute manual test cases inside a release and record test results during execution.
- [Sessions](https://docs.testdino.com/test-management/manual-testing/sessions): Run exploratory testing sessions, log findings with attachments and linked issues, and roll up activity per release.

## Organization

- [TestDino Organizations](https://docs.testdino.com/platform/organization-overview): Create and switch organizations, and manage members, roles, single sign-on, analytics, and billing across every project.
- [Projects](https://docs.testdino.com/platform/organizations/projects): Create and manage projects that isolate test data, keys, and analytics.
- [Analytics](https://docs.testdino.com/platform/organizations/analytics): See test health across every project in your organization: live risk counts, pass and flaky trends, per-project health, and plan capacity.
- [Users & Roles](https://docs.testdino.com/platform/organizations/users-roles): Manage team members, assign roles, and control access across your organization.
- [Settings](https://docs.testdino.com/platform/organizations/settings): Update your organization name, logo, and profile details.
- [Single Sign-On (SSO)](https://docs.testdino.com/platform/organizations/single-sign-on): Set up per-organization single sign-on with OIDC, verify your domains, and enforce SSO from the TestDino settings UI.

### Billing & Usage

- [TestDino Billing and Usage Overview](https://docs.testdino.com/platform/billing-and-usage/overview): Review your subscription, plan allowances, per-project usage, and usage trends from the TestDino Billing & Usage page.
- [Manage Billing](https://docs.testdino.com/platform/billing-and-usage/manage-billing): Upgrade, cancel, and manage your TestDino subscription, and understand monthly and annual billing.
- [Invoices](https://docs.testdino.com/platform/billing-and-usage/invoices): View, filter, and download your organization's billing invoices from the TestDino Invoices tab.
- [Billing & Pricing](https://docs.testdino.com/pricing): Compare TestDino plans, test usage limits, and billing cycles across the Community, Pro, Team, and Enterprise tiers.

## Integrations

- [Overview](https://docs.testdino.com/integrations/overview): Connect external platforms to bring TestDino insights where your team works.

### CI/CD

- [GitHub App](https://docs.testdino.com/integrations/ci-cd/github): Connect the TestDino GitHub App for PR comments, CI checks, and pull request sync.
- [GitLab App](https://docs.testdino.com/integrations/playwright-gitlab-ci): Connect TestDino to GitLab for MR comments and merge request sync.
- [GitLab Self-Managed](https://docs.testdino.com/integrations/playwright-gitlab-self-hosted): Connect TestDino to self-managed GitLab for MR and commit comments.
- [Azure DevOps App](https://docs.testdino.com/integrations/playwright-azure-devops): Connect the TestDino Azure DevOps extension to view test runs inside Azure DevOps.

### Issue Tracking

- [Jira](https://docs.testdino.com/integrations/jira-playwright-test-failures): Create Jira issues from failed or flaky Playwright tests in TestDino.
- [Jira Forge App](https://docs.testdino.com/integrations/issue-tracking/jira-forge-app): Install the TestDino Forge app to view linked test cases, runs, sessions, and releases inside Jira issues.
- [Linear](https://docs.testdino.com/integrations/issue-tracking/linear): Create Linear issues from failed or flaky Playwright tests in TestDino.
- [Asana](https://docs.testdino.com/integrations/issue-tracking/asana): Create Asana tasks from failed or flaky Playwright tests in TestDino.
- [monday](https://docs.testdino.com/integrations/issue-tracking/mon): Create monday items and view test run data in monday dashboards from TestDino.

### Communication

- [Slack App](https://docs.testdino.com/integrations/slack-playwright-test-alerts): Send test run summaries, annotation-based failure alerts, and tag-based notifications to Slack.
- [Slack Webhook](https://docs.testdino.com/integrations/slack/webhook): Send test run notifications to a Slack channel via incoming webhook.
- [OpenClaw](https://docs.testdino.com/integrations/communication/openclaw): Wire TestDino into OpenClaw and ask TestDino about Playwright failures directly from any OpenClaw supported chat app.

### Automation

- [n8n](https://docs.testdino.com/integrations/automation/n8n): Connect TestDino to n8n with the community node to trigger workflows on test runs and query Playwright data without code.

## Data Privacy

- [Data Privacy](https://docs.testdino.com/data-privacy/overview): How TestDino handles customer data from Playwright test runs, including collection, storage, redaction, and retention policies.
- [Security & Compliance](https://docs.testdino.com/data-privacy/security-compliance): TestDino is SOC 2 Type 2 and ISO 27001 certified, GDPR compliant, and hosted on Microsoft Azure with encryption in transit and at rest.
- [Access to Customer Data](https://docs.testdino.com/data-privacy/access-to-customer-data): Full breakdown of data categories TestDino collects during test execution, account registration, and product usage.
- [Data Redaction](https://docs.testdino.com/data-privacy/data-redaction): TestDino automatically detects and scrubs secrets, tokens, and API keys from Playwright trace files and test artifacts before storing them.
- [Data Retention](https://docs.testdino.com/data-privacy/data-retention): TestDino retention periods and plan limits across Pro, Team, and Enterprise tiers.
- [Cloud Endpoints](https://docs.testdino.com/data-privacy/cloud-endpoints): Complete list of internet-facing TestDino services, domains, and IP ranges used to send Playwright test results and artifacts securely.

## Resources

- [Support](https://docs.testdino.com/support): Contact the TestDino support team for help with setup, integrations, billing, or product questions via email or community channels.
- [Changelog](https://docs.testdino.com/changelog): Latest TestDino product updates, new features, bug fixes, and Playwright reporting improvements.

## Optional

Skip these when a shorter context is needed. They are reference and background material, not setup or feature documentation.

- [Alternatives](https://docs.testdino.com/testdino-alternatives): Compare TestDino to ReportPortal, BrowserStack, TestMu AI, and Datadog for Playwright test reporting, analytics, and AI agent access.
- [Glossary](https://docs.testdino.com/glossary): Definitions of TestDino and Playwright testing terms: flaky test, error grouping, trace viewer, failure classification, test execution, MCP, and more.
- [FAQs](https://docs.testdino.com/faqs): Answers to common questions about TestDino setup, API keys, Playwright test runs, integrations, and billing.
- [Changelog](https://docs.testdino.com/changelog): Latest TestDino product updates, new features, bug fixes, and Playwright reporting improvements.
- [Support](https://docs.testdino.com/support): Contact the TestDino support team for help with setup, integrations, billing, or product questions via email or community channels.
- [Billing & Pricing](https://docs.testdino.com/pricing): Compare TestDino plans, test usage limits, and billing cycles across the Community, Pro, Team, and Enterprise tiers.
- [Cloud Endpoints](https://docs.testdino.com/data-privacy/cloud-endpoints): Complete list of internet-facing TestDino services, domains, and IP ranges used to send Playwright test results and artifacts securely.