Testing workflow

AlignTrue uses Vitest for unit and integration tests. All contributions must include tests.

Running tests

Run all tests:

pnpm test

Run tests for a specific package:

pnpm --filter @aligntrue/core test

Watch mode:

pnpm test --watch

Test structure

Tests mirror source structure:

packages/core/
├── src/
│   └── bundle.ts
└── tests/
    └── bundle.test.ts

Writing tests

Follow TDD workflow:

1. Write failing test
2. Implement feature
3. Verify test passes
4. Refactor

See .cursor/rules/tdd.mdc for detailed TDD workflow.

Test quality

• Cover edge cases and error paths
• Test determinism for exports
• Use explicit assertions
• Keep tests fast (<3 minutes total suite)

Coverage

Target 80%+ coverage for new features. Check coverage:

pnpm test --coverage