About testing
A testing guide for project contributors, organized by test type with relevant documentation and commands. It covers unit, integration, database, end-to-end, and LLM testing and evaluation.
Key features
- 01Guidance organized by test type
- 02Commands for unit and integration tests
- 03Database and end-to-end test notes
- 04LLM regression and model evaluation
Use cases
- 01Run unit tests for one file
- 02Execute emulator-backed integration tests
- 03Compare evaluation results across models
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ elie222/ inbox-zero --skill testingAfter installing, type/testingin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
e2e.mdeval.mdintegration.mdllm.mdunit.mdwrite-tests.mdDetails
From the project READMETesting
All testing guidance lives in this directory. Read the relevant file for your task:
| Type | File | When to use |
|---|---|---|
| Unit tests | unit.md | Framework setup, mocks, colocated tests |
| Writing tests | write-tests.md | What to test, what to skip, workflow |
| LLM tests | llm.md | Tests that call real LLMs (pnpm test-ai) |
| Eval suite | eval.md | Cross-model comparison, LLM-as-judge |
| Integration | integration.md | Emulator-backed tests (pnpm test-integration) |
| Database | apps/web/__tests__/db/README.md | Real Postgres, for unique constraints and updateMany count guards (pnpm test-db) |
| E2E tests | e2e.md | Real email workflow tests from inbox-zero-e2e repo |
Prefer behavior-focused assertions; avoid freezing prompt copy or internal call shapes unless those exact values are the contract under test.
Quick Commands
pnpm test path/to/file.test.ts # Single unit test
pnpm test # All unit tests
pnpm test-integration # Integration tests (emulator)
pnpm test-db # Database tests (needs DATABASE_URL on a throwaway db)
pnpm test-ai ai-regression/your-feature # Live AI regression test
EVAL_MODELS=all pnpm test-ai eval/your-feature # Eval across models
Comments
Markdown supported