An opinionated boilerplate project using Django with a dockerized development environment and a production-ready docker image for deployment.
- Django 5.1
- Python 3.13
- Postgres 17
- Docker Compose for local development
- Dockerfile for building a production-ready image
- Justfile recipes
- uv for package and project management
- ruff, pytest, django-environ, and many more nice tools
This project leverages uv, just and Docker Compose for managing the development environment. Make sure you have installed he necessary dependencies for running them on your local machine.
Initialize the dev environment with the just bootstrap recipe. This will build the dev image and prepare everything before you can start the app and the dependant infrastructure services with the just start recipe. Stop all services with hitting CTRL+C or using the just stop recipe in another terminal.
just bootstrap
just startThe most used project commands are available as just recipe:
just [recipe]Available recipes:
bootstrap *ARGS # bootstrap project
build *ARGS # build project
start *ARGS # start project
stop *ARGS # stop project
infra-start *ARGS # start infra services
infra-stop *ARGS # stop infra services
app-start *ARGS # start django app
app-stop *ARGS # start django app
run *ARGS # uv run command in container
manage *ARGS # run django management command
env # copy .env.example to .env if not exists
pre *ARGS # run pre-commit processes
ruff *ARGS # run ruff linting & formatting
test *ARGS # run tests
test-cov *ARGS # run tests with coverage
clean *ARGS # clean up cache files etc.This boilerplate is inspired by Nick Janetakis' docker-django-example and Jeff Triplett's django-startproject. I used a lot of patterns, practices and also code snippets from their projects. I highly recommend taking a look at their repos as it may be more usefull. This boilerplate is an opinionated copy/mix of their work to make it fit my personal needs.