DocumentationTesting
Testing
pytest Layout (Backend)
- Application-specific tests live inside their respective apps (e.g.,
users/tests/,pipeline/tests/). - The top-level
tests/directory is reserved strictly for full-system integration tests. - Ensure you are running under the host-side track (SQLite
memory:) for speed. Example:just backend-test.
Vitest Layout (Frontend)
- Tests live immediately beside the files they test (e.g.,
index.test.tsx). - We do not use separate
__tests__/folders.
Storybook Usage
- UI components in
elements/andlayout/should have.stories.tsxfiles demonstrating their permutations.
Coverage Expectations
Use the .github/skills/coverage-auditor/SKILL.md to spot gaps. All new logic branches in APIs, serializers, and utility functions should be covered.
When to Use just Test Targets
just test: Runs all backend AND frontend tests.just backend-test: Only runspytest.just frontend-test: Only runsvitest.