Thanks for contributing. Keep changes focused, small, and aligned with the existing project conventions.
- Read
AGENTS.mdfor the full coding, documentation, testing, and workflow rules. - Use Node 24 and pnpm only.
- Create branches with a conventional prefix, such as
fix/,feat/,docs/,chore/, orrefactor/. - Keep dependency changes separate unless they are required for the work.
nvm use
corepack enable
pnpm install
cp .env.example .env
pnpm devUse pnpm compose up -d postgres redis when you only need supporting local
services. Use pnpm compose up -d --build when you want the app and services to
run through Docker Compose.
Run the relevant checks before opening a pull request:
pnpm lint
pnpm typecheck
pnpm test
pnpm build- Use a conventional PR title.
- Explain what changed and how it was tested.
- Include both unit and integration coverage for behaviour changes.
- Do not commit local env overrides or the root
.env.