hermes-kanban-miniapp/CONTRIBUTING.md

Contributing

Thanks for helping improve Hermes Kanban Mini App.

Development

1. Fork or clone the repository.
2. Copy .env.example to .env and use local/dev values only.
3. Run backend tests with cd backend && ../.venv/bin/pytest or create your own venv.
4. Run frontend tests with cd frontend && npm test.
5. Run npm run build before opening a PR.

Pull requests

• Keep changes focused.
• Add or update tests for behavior changes.
• Do not commit .env, bot tokens, chat IDs, personal hostnames, or private board data.
• Prefer fixed Hermes Kanban CLI actions over generic command execution.

Code style

• Backend: typed Python, FastAPI, Pydantic models for request validation.
• Frontend: React + TypeScript, mobile-first UI, no heavy Telegram SDK lock-in.