Contributing

We welcome issues and pull requests. Please keep the tone friendly and the focus on privacy and usability.

How to file issues and PRs

• Search existing issues before opening a new one
• Use clear titles and steps to reproduce
• Open PRs early as drafts for feedback

Dev setup

Backend: Python 3.12, Flask app factory at src.backend.app.__init__.py::create_app(). MongoDB required.

pip install -r src/backend/requirements.txt
export FLASK_APP=src.backend.app
flask run

Or use Docker for dev.

Code style

• Python: Black, ruff (if configured)
• Commits: Conventional commits (recommended)

Code of Conduct

Be kind. Assume good intent. No harassment or discrimination.