Frequently asked questions about developing in this project.
Q: Where do I start? See Getting Started for the full setup guide.
Q: I found a bug. How do I report it? Open a Bug Report issue using the provided template.
Q: I want to add a feature. Where do I begin? Open a Feature Request issue first to discuss the idea before writing code.
Q: Tests are failing locally but passing in CI (or vice versa).
- Make sure your
.envmatches the values expected by the test suite - Run
pnpm install --frozen-lockfileto ensure your dependencies match the lockfile
Q: How do I run a single test file?
pnpm vitest run path/to/your.test.tsQ: The build fails with type errors I didn't introduce.
Pull the latest main and run pnpm install — a dependency may have been updated.
Q: How large should a PR be? Aim for PRs that can be reviewed in under 30 minutes. Split larger changes into multiple PRs if possible.
Q: Do I need to write tests for every change? Yes for new features and bug fixes. Documentation-only PRs are exempt.
Q: Who merges PRs? Maintainers merge PRs once they have one approving review and all CI checks are green.
Still stuck? Open a Discussion.