Thanks for taking the time to contribute!
Prereqs:
- Node.js
uv(Python package manager)- Python 3.12+
- Git
Setup:
pnpm setup:devRun:
pnpm devDebug:
pnpm dev:debugTypecheck:
pnpm typecheck- Bug fixes and small improvements
- Documentation updates
- Small, targeted UI fixes
Frontend policy: the frontend is under active refactor. Please avoid large UI/state rewrites for now — open an issue first so we can align on the target direction.
Before starting a larger change (especially frontend architecture/state), please open an issue with:
- The problem you’re trying to solve
- The proposed approach (1–2 paragraphs is fine)
- Scope (areas/files likely to change)
- Any UX or compatibility impact
Wait for maintainer alignment before investing in a major refactor.
At minimum, run:
- Type checking:
pnpm typecheck- Backend tests:
pnpm backend:test