Django-React starter with Docker support for fast and easy web development with:
🥷 Backend: Django + DRF + Celery
✨ Frontend: Vite + React + DaisyUI
💻 Database: Postgres + PostGIS
🔍 Search engine: Meilisearch and its UI
🗨️ Messaging: RabbitMQ
🚀 Deployment: Fly.io
Login | Responsive |
---|---|
![]() |
![]() |
Register | Password reset | Password reset confirm |
---|---|---|
![]() |
![]() |
![]() |
Homepage | Settings | Dark mode and i18n French |
---|---|---|
![]() |
![]() |
![]() |
Simply follow these steps to get started:
- Fork this repository
- Clone your fork
- Update documentation:
- Use the
README.example.md
file as a template for your ownREADME.md
file - Use the
CHANGELOG.example.md
file as a template for your ownCHANGELOG.md
file - Update the
LICENSE
file
- Use the
- Update the code:
- Replace all occurrences of
django_react_starter
withyour_project_name
- Replace all occurrences of
django-react-starter
withyour-project-name
- Replace all occurrences of
Django React Starter
withYour Project Name
- Replace all occurrences of
Jordan-Kowal
withYour GitHub Username
(used in GitHub actions) - Replace all occurrences of
Jordan Kowal
withYour Name
- Replace all occurrences of
kowaljordan@gmail.com
withyour email address
- Update whatever you see fit
- Use
docker compose up
ormake start
ormake start.lite
to run the application locally
- Replace all occurrences of
- Deployment:
- Create your own fly.toml file using
fly launch
(see Fly.io for more information) or use the templated files in thefly
folder - If you want to use sentry for the frontend, add the required
VITE_SENTRY_DSN
GitHub repository secrets
- Create your own fly.toml file using
- Start coding!
🎬 Ready-to-use fully-tested application with multiple features:
- Login / Register / Password reset
- Profile management
- Health checks
- Example of Celery/RabbitMQ/Meilisearch integration
🐳 Docker integration:
Dockerfiles
for both development and productiondocker compose
to run the entire app locallyMakefile
for easy access to frequent commands
✨ Quality tools:
- Tests, linters, and formatters for both backend and frontend
- Pre-commits hooks
- CI/CD for QA, dependencies, and deployment
...and many other utilities!