Appearance
Introduction
EasyTrace turns test-report files from CI or your machine into runs, failures, flaky-test history and coverage. It does not replace your test runner:
- Your test runner writes a report file (JSON or JUnit XML) — a flag or one line of config.
- When the tests finish, the EasyTrace CLI reads the report files and uploads them.
- The dashboard shows the run a few seconds later.
text
vitest / jest / playwright / cypress / mocha / pytest / phpunit ──► report file ──► easytrace CLI ──► EasyTraceThe CLI keeps your test command's exit code; upload problems are warnings unless you opt into --strict.

Concepts
| Term | Meaning |
|---|---|
| Organization | Workspace for projects, members and usage. |
| Project | One codebase (usually one repository). Runs, test history and project tokens belong to a project. |
| Suite | A named group of tests uploaded together, e.g. unit, e2e, or one per package (server, web). Each suite of a build becomes its own run. |
| Build | One CI pipeline or CLI invocation. Its suites share a build id. |
| Run | The results of one suite in one build: counts, failures, flaky tests, coverage, artifacts. |
| Flaky test | A test with same-branch final pass/fail outcome changes whose change rate meets the project threshold. A retry fail followed by a pass is a passed result. |
| Shard | Part of a suite run on another machine (parallel CI jobs). Shards with the same build id and suite merge into one run. |
| Origin | CI or Local; local runs show their uploader. |
| New failure baseline | The latest earlier finished run of the same project and suite on the default branch, whether or not it has coverage. A failure that passed or was skipped in that run is a new failure. |
| Coverage baseline | The latest earlier finished run of the same project and suite on the default branch that has coverage. It may be older than the new failure baseline. |
Supported reports
| Format | Written by |
|---|---|
vitest-json | Vitest --reporter=json |
jest-json | jest --json --outputFile=… |
playwright-json | Playwright json reporter |
mochawesome | Cypress with the mochawesome reporter (json=true) |
mocha-json | Mocha --reporter json |
pytest-xml | pytest --junit-xml=… |
phpunit-xml | PHPUnit --log-junit … |
junit | Almost every tool (JUnit XML) |
Formats are detected from content, except pytest and PHPUnit: set pytest-xml or phpunit-xml. See Writing report files.
Two ways to authenticate
| Developer machine | CI | |
|---|---|---|
| Credential | easytrace login once per machine | Project token in EASYTRACE_TOKEN |
| Project | project in easytrace.config.json | Decided by the token |
| Shown as | Local, uploaded by you | CI |
Details: Credentials and tokens.