Thank you for your interest in contributing to Archon!
- Fork the repository
- Clone your fork
- Install dependencies:
bun install - Copy
.env.exampleto.envand configure - Start development:
bun run dev
Before submitting a PR, ensure:
bun run type-check # TypeScript types
bun run lint # ESLint
bun run format # Prettier
bun run test # All tests (per-package isolation)
# Or run the full validation suite:
bun run validateImportant: Use bun run test (not bun test from the repo root) to avoid mock pollution across packages.
- Use present tense ("Add feature" not "Added feature")
- Keep the first line under 72 characters
- Reference issues when applicable
- Create a feature branch from
dev - Make your changes
- Ensure all checks pass
- Submit a PR with a clear description
- TypeScript strict mode is enforced
- All functions require explicit return types
- No
anytypes without justification - Follow existing patterns in the codebase
See CLAUDE.md for detailed architecture documentation.
Open an issue or start a discussion.