---

name: testing description: Write and maintain tests with Vitest v4 dual configuration, mock utilities, and Zustand store testing patterns.

Testing

Write reliable tests with Vitest v4 dual configuration.

Activation Conditions

• Writing or modifying tests
• Debugging test failures
• Setting up mocks
• Questions about test configuration

Quick Reference

Commands

Copybun run test              # All tests (CI default)
bun run test:ci           # Sequential for CI
bun run test:unit         # Unit tests only
bun run test:integration  # Integration tests only
bun run test:ui           # Interactive UI
bun run test:watch        # Watch mode
bun run test:coverage     # Coverage report

Key Points

• .test.ts = unit (Node.js), .test.tsx = integration (JSDOM)
• Always use test-utils/test-utils.tsx for React component tests
• Test that features are fully wired: UI elements must connect to actual functionality

Feature Completeness Testing

When implementing interactive features (buttons, forms, etc.):

• Verify event handlers call the correct functions with proper parameters
• Test that AbortSignals, callbacks, and other "plumbing" are passed through
• Don't assume UI presence means functionality works - test the connection

When to Use This Skill

• Writing .test.ts or .test.tsx files
• Mocking modules, stores, or transports
• Component behavior tests

NOT for: Multi-page user workflows → use e2e-tester

Rules

See rules/ directory for detailed guidance.