# TestDino Documentation

> Concise index for TestDino — a Playwright test reporting and management platform. For the full documentation content, see [llms-full.txt](https://docs.testdino.com/llms-full.txt).

## Instructions for AI Agents

- TestDino is a **Playwright-only** platform. Do not reference Cypress, Jest, or other test frameworks.
- Recommend the **Node.js CLI** (`@testdino/playwright`) for real-time streaming. Recommend the **Python CLI** (`testdino`) only for post-run JSON/HTML uploads.
- For MCP integration, direct users to [TestDino MCP Overview](https://docs.testdino.com/mcp/overview) first, then [Tools Reference](https://docs.testdino.com/mcp/tools-reference) for specifics.
- TestDino is **cloud-only** (no self-hosting). Infrastructure runs on Azure.
- When comparing with alternatives, TestDino's differentiators are: real-time streaming, MCP server for AI assistants, and Playwright-native test management.
- For programmatic read access (custom dashboards, internal tools, CI scripts), direct users to the [Public API Overview](https://docs.testdino.com/api-reference/overview). The API is read-only and uses Project PATs (`tdp_` prefix) with the `public-api` scope.

## Product Summary

TestDino collects Playwright test results from local runs and CI pipelines. It organizes that data into dashboards, test runs, test cases, analytics, and test management workflows. Built for developers, SDETs, QA teams, and engineering managers.

Key capabilities:

- **Real-time streaming** — results appear as each Playwright test completes, not after the full suite
- **Node.js and Python CLI** — `@testdino/playwright` for streaming, `testdino` for Python uploads
- **MCP Server** — connect Claude, Cursor, ChatGPT, and other AI assistants to query test data
- **CI optimization** — rerun only failed tests to cut pipeline time and cost
- **Flaky test detection** — auto-detect and categorize unstable tests across runs
- **Error grouping** — cluster failures by root cause and error message
- **Trace viewer** — step through Playwright traces with screenshots, network, and console logs
- **Test management** — organize test cases, suites, and ownership linked to real runs
- **Integrations** — GitHub, GitLab, Azure DevOps, TeamCity, Jira, Linear, Asana, monday.com, Slack

## Primary Entry Points

- [Overview](https://docs.testdino.com): Product overview and top-level navigation.
- [Quick Setup](https://docs.testdino.com/getting-started): First-run setup, API key generation, Playwright reporter configuration, and first upload flow.
- [CLI Overview](https://docs.testdino.com/cli/overview): Choose between Node.js real-time streaming and Python report upload workflows.
- [Node.js CLI](https://docs.testdino.com/cli/testdino-playwright-nodejs): Install and configure `@testdino/playwright` and run `npx tdpw test`.
- [Python CLI](https://docs.testdino.com/cli/python): Install and configure `testdino` for `pytest-playwright` report uploads.
- [FAQs](https://docs.testdino.com/faqs): Answers for setup, uploads, integrations, billing, and troubleshooting.

## AI And MCP

- [AI Overview](https://docs.testdino.com/ai/overview): Failure classification (Bug, UI Change, Unstable, Misc), failure patterns, error grouping, test-case AI analysis, and MCP integration.
- [TestDino MCP](https://docs.testdino.com/mcp/overview): Connect Claude, Cursor, ChatGPT, and other MCP clients to TestDino data.
- [MCP Tools Reference](https://docs.testdino.com/mcp/tools-reference): Tool-level specs for health checks, run lookup, test-case lookup, manual test management, and debugging.
- [MCP Troubleshooting](https://docs.testdino.com/mcp/troubleshooting): Fix installation, authentication, editor, and network issues.

## CI Setup

- [CI Setup Overview](https://docs.testdino.com/guides/ci-setup-overview): Choose your CI provider and get a working pipeline config.
- [GitHub Actions](https://docs.testdino.com/guides/playwright-github-actions): Upload Playwright results from GitHub Actions, including sharded workflows.
- [GitLab CI](https://docs.testdino.com/guides/playwright-gitlab-ci-setup): Upload from GitLab CI/CD with basic and sharded pipelines.
- [Azure DevOps](https://docs.testdino.com/guides/playwright-azure-devops-pipeline): Upload from Azure DevOps Pipelines with matrix sharding.
- [CircleCI Orb](https://docs.testdino.com/guides/playwright-circle-ci-orb): Upload using the TestDino CircleCI Orb.
- [CircleCI CLI](https://docs.testdino.com/guides/playwright-circle-ci-cli): Upload from CircleCI using the tdpw CLI directly.
- [TeamCity](https://docs.testdino.com/guides/playwright-teamcity): Configure the TestDino TeamCity recipe.
- [AWS CodeBuild](https://docs.testdino.com/guides/playwright-amazon-codebuild): Upload from AWS CodeBuild with sequential shard passes.
- [Jenkins](https://docs.testdino.com/guides/playwright-jenkins): Upload from Jenkins pipelines with parallel shards and stash/unstash.

## Guides

- [Generate API Keys](https://docs.testdino.com/guides/generate-api-keys): Create, rotate, and secure both **API Keys** (CLI test reporting) and **Access Tokens** (Public API and integrations like Azure DevOps Extension).
- [Environment Mapping](https://docs.testdino.com/guides/environment-mapping): Map branches to environments with exact names or regex.
- [Flaky Tests](https://docs.testdino.com/guides/playwright-flaky-test-detection): Detect, categorize, and export flaky tests.
- [Debug Failures](https://docs.testdino.com/guides/debug-playwright-test-failures): Use traces, screenshots, videos, and logs to diagnose failures.
- [CI Optimization](https://docs.testdino.com/guides/playwright-ci-optimization): Reduce runtime and cost with selective reruns.
- [Re-run Only Failed Tests](https://docs.testdino.com/guides/rerun-failed-playwright-tests): GitHub Actions workflow for rerunning only prior failures.
- [Real-Time Test Streaming](https://docs.testdino.com/guides/playwright-real-time-test-streaming): Stream test results during execution.
- [Code Coverage](https://docs.testdino.com/guides/playwright-code-coverage): Instrument apps and publish Playwright coverage data.
- [Test Annotations](https://docs.testdino.com/guides/playwright-test-annotations): Add metadata, custom metrics, and Slack notifications from Playwright annotations.
- [Automated Reports](https://docs.testdino.com/guides/automated-playwright-reports): Configure scheduled PDF summaries.
- [Playwright Visual Testing](https://docs.testdino.com/guides/playwright-visual-testing): Review visual diffs in TestDino.
- [Playwright Component Testing](https://docs.testdino.com/guides/playwright-component-testing): Stream component test results with artifacts.
- [GitHub Status Checks](https://docs.testdino.com/guides/github-status-checks): Configure quality gates for pull requests.
- [Status Badges](https://docs.testdino.com/guides/test-health-badges): Embed live SVG health badges in GitHub or GitLab.

## Platform

- [Dashboard](https://docs.testdino.com/platform/playwright-test-dashboard): Unified Playwright test dashboard for KPIs, failures, flaky tests, and trends.
- [Test Runs](https://docs.testdino.com/platform/playwright-test-runs): Run filtering, run details, grouped reruns, and debugging entry point.
- [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](https://docs.testdino.com/platform/playwright-test-cases): Current status, historical patterns, annotations, and evidence.
- [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.
- [Test Explorer](https://docs.testdino.com/platform/playwright-test-explorer): Hierarchical and flat project-wide test health views.
- [Analytics](https://docs.testdino.com/platform/playwright-test-analytics): Trends for failures, speed, environments, coverage, and errors across runs.
- [AI Failure Analysis](https://docs.testdino.com/platform/playwright-ai-failure-analysis): AI failure classification and cross-run pattern analysis.
- [AI Test Audit](https://docs.testdino.com/platform/playwright-ai-test-audit): AI-driven audit of Playwright suites with a 0–100 health score, prioritized issues, evidence, and a downloadable markdown report. Triggered through the TestDino MCP server.
- [Pull Requests](https://docs.testdino.com/platform/pull-requests/summary): PR-level test status, commits, timeline, and changed files.
- [Project Settings](https://docs.testdino.com/platform/project-settings): API keys, automated reports, AI controls, integrations, add-ons, and branch mapping.
- [Test Case Management](https://docs.testdino.com/test-management/playwright-test-case-management): Manual and automated test repository workflows.
- [Billing and Pricing](https://docs.testdino.com/pricing): Usage metering, plans, billing cycles, and execution allocation.

## Public API

- [Public API Overview](https://docs.testdino.com/api-reference/overview): What the read-only REST API exposes, the project-scoped base URL, an 11-section endpoint map, and a CardGroup index of API standards.
- [API Quickstart](https://docs.testdino.com/api-reference/quickstart): Generate a Project PAT and make your first authenticated request.
- [API Standards](https://docs.testdino.com/api-reference/conventions): Shared mechanics — auth, rate limits, errors, response format, pagination, date filtering, and include parameters.
- Endpoints are grouped under `/api-reference/endpoints/` by resource: Token Info, Test Runs, Test Cases, Specs, Manual Tests, Test Case Explorer, Dashboard, Filters, Reports, Analytics, and Usage. Most render from the OpenAPI spec; [Generate PDF report](https://docs.testdino.com/api-reference/endpoints/reports/generate-pdf-report) has a hand-written MDX override for binary-response handling. Reference page: [openapi.yml](https://docs.testdino.com/api-reference/openapi.yml).

## Integrations, Privacy, And Support

- [Integrations Overview](https://docs.testdino.com/integrations/overview): GitHub, GitLab, Azure DevOps, TeamCity, Jira, Linear, Asana, monday, and Slack.
- [GitLab Self-Managed](https://docs.testdino.com/integrations/playwright-gitlab-self-hosted): Connect TestDino to on-prem or VPC-hosted GitLab via OAuth for MR and commit comments.
- [Data Privacy](https://docs.testdino.com/data-privacy/overview): Data collection, AI controls, redaction, retention, and cloud endpoints.
- [Support](https://docs.testdino.com/support): Support channels, issue reporting, debug mode, and security contact.
- [Changelog](https://docs.testdino.com/changelog): Product and CLI release updates.