Appearance
Quickstart
Upload a first Vitest run in about five minutes. Other runners follow the same pattern.
1. Create a project
Sign in with GitHub, then open Projects → New project. The Setup tab contains the project token for CI; you do not need it yet.
2. Install the CLI
bash
pnpm add -D @easytrace/cli3. Sign in from your machine
bash
pnpm exec easytrace loginThe CLI prints a code and opens your browser. Check that the code on the page matches your terminal, then click Authorize. The terminal prints Signed in as @you on https://api.easytrace.dev.
4. Describe the repository
bash
pnpm exec easytrace initinit asks for the project, suggests suites from installed runners and writes easytrace.config.json:
json
{
"project": "01933c2e-5f0a-7cc1-9a4e-2b1d9f3e6a10",
"suites": {
"unit": { "reports": ".easytrace/vitest.json" }
}
}Commit the config; it contains no secret. Add .easytrace/ to .gitignore.
5. Make the tests write a report
json
{
"scripts": {
"test:report": "easytrace run -- vitest run --reporter=default --reporter=json --outputFile.json=.easytrace/vitest.json"
}
}--reporter=default keeps the usual terminal output; the JSON reporter writes the file EasyTrace reads.
6. Run
bash
pnpm test:reportThe tests run normally, then the CLI uploads the report and prints a link:
text
Uploaded 1 failed, 212 passed from 1 file (suite unit) → https://app.easytrace.dev/app/runs/…The command keeps your tests' exit code, so it can replace pnpm test.
Next steps
- Monorepo, Playwright, Jest, Cypress: Writing report files
- Upload from CI: Continuous integration
- Coverage: Coverage