About playwright-ci
Playwright CI/CD is a guide set for teams running Playwright tests in continuous integration pipelines. It covers provider setup, execution at scale, containers, reporting, and infrastructure practices.
Key features
- 01CI provider setup guides
- 02Parallel execution and sharding
- 03Docker and container guidance
- 04Reports and artifact handling
- 05Coverage and global setup guidance
Use cases
- 01Configure Playwright in a CI pipeline
- 02Split tests across CI runners
- 03Collect traces and reports after failures
- 04Reuse authentication state across workers
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/playwright-ciin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
ci-github-actions.mdci-gitlab.mdci-other.mddocker-and-containers.mdglobal-setup-teardown.mdparallel-and-sharding.mdprojects-and-dependencies.mdreporting-and-artifacts.mdtest-coverage.mdDetails
From the project READMEPlaywright CI/CD
Ship reliable tests in every pipeline — CI-specific patterns for speed, stability, and actionable reports.
9 guides covering CI/CD setup, parallel execution, containerized runs, reporting, and infrastructure patterns for all major CI providers.
Golden Rules
retries: 2in CI only — surface flakiness in pipelines, not locallytraces: 'on-first-retry'— capture rich debugging artifacts without slowing every run- Shard across runners —
--shard=N/Msplits tests evenly; scale horizontally, not vertically - Cache browser binaries —
~/.cache/ms-playwrightkeyed on Playwright version - Upload artifacts on failure — traces, screenshots, and HTML reports as CI artifacts
- Use the official Docker image —
mcr.microsoft.com/playwright:v*has all OS deps pre-installed - Global setup for auth — run login once in
globalSetup, reusestorageStateacross workers - Fail fast, debug later — keep CI runs short; use trace viewer and HTML reports to investigate
Guide Index
CI Providers
| Provider | Guide |
|---|---|
| GitHub Actions | ci-github-actions.md |
| GitLab CI | ci-gitlab.md |
| CircleCI / Azure DevOps / Jenkins | ci-other.md |
Execution & Scaling
| Topic | Guide |
|---|---|
| Parallel execution & sharding | parallel-and-sharding.md |
| Docker & containers | docker-and-containers.md |
| Multi-project config | projects-and-dependencies.md |
Reporting & Setup
| Topic | Guide |
|---|---|
| Reports & artifacts | reporting-and-artifacts.md |
| Code coverage | test-coverage.md |
| Global setup/teardown | global-setup-teardown.md |
Comments
Markdown supported