Developer Guide
Welcome to the HOPE Developer Guide! This documentation will help you set up your development environment and start contributing to the project.
Quick Start
- Setup - Install prerequisites and configure your environment
- Running - Start the application (multiple options available)
- Testing - Run unit and E2E tests
- Linting - Code quality and formatting
- Stack - Technology overview
- Contributing - Guidelines for contributors
Development Options
HOPE supports three development workflows:
| Option | Best For | Frontend | Backend |
|---|---|---|---|
| Local + Build Watch (Recommended) | Full integration | Built to Django static | Local venv |
| Local + Vite Dev | Frontend dev with HMR | Vite dev server | Local venv |
| Full Docker | Production-like env | Vite dev server | Docker container |
Choose the option that best fits your workflow. See Running for detailed instructions.
Support
- GitHub Issues: unicef/hope ⧉
- Documentation: You're reading it!