Prerequisites
- A TestDino account (sign up if you haven’t)
- A Playwright project with tests (or clone the TestDino Example Repository to get started)
Set up with an AI agent
Copy the prompt below into Cursor, Claude Code, or another AI coding assistant. It carries the verified steps and guardrails for uploading your first run, so the agent configures the reporters and runs the upload for you.Use this pre-built prompt to set up TestDino faster.
Set Up Your First Project
Get your API key
Go to Project Settings → API Keys and generate a new key. Copy and save it securely.

Export your API key
Store the key in the
TESTDINO_TOKEN environment variable so the CLI can read it. Every command below uses this variable.NoteNever hardcode the key in source or CI config. In CI, store it as a secret and reference it as an environment variable.
Install the TestDino CLI
- Node.js
- Python
Configure Playwright reporters
- Node.js
- Python
Add JSON and HTML reporters to your Playwright config:
playwright.config.js
NoteThe HTML reporter must be listed before the JSON reporter. Playwright’s HTML reporter clears its output directory on each run, so placing it first ensures
report.json is not deleted.Run tests and upload
- Node.js
- Python
NoteExport your API key as the
TESTDINO_TOKEN environment variable. Never hardcode it in source or CI config.Verify in TestDino
Open Test Runs in your TestDino project. You should see your run at the top of the list with its pass/fail counts, duration, and a link into the full report with traces and screenshots. If it appears, your setup is working.

No run showing up? The most common cause is reporter order. The HTML reporter must be listed before the JSON reporter in
playwright.config.js, or report.json gets cleared before upload. See Quick Setup troubleshooting if it persists.Integrate with your CI pipeline
Automate test uploads by adding TestDino to your CI workflow.Follow the CI Setup Guide to configure your provider (GitHub Actions, GitLab CI, Azure DevOps, CircleCI, TeamCity, and more).Optionally, set up Branch Mapping to organize test runs by environment.
Connect your tools
Connect your communication and project management tools to route test results where your team works:
- Slack: get notified on test failures
- Jira: auto-create tickets from failures
- GitHub: PR comments and status checks
- All Integrations: Linear, Asana, Monday.com, and more
Next Steps
TestDino MCP
Access test results and fix issues directly with AI agents
Users & Roles
Invite and manage team members in your organization
