Skip to content

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/cli

3. Sign in from your machine ​

bash
pnpm exec easytrace login

The 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 init

init 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:report

The 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 ​