Prerequisites

• Nix (>= 2.13)
• Docker
• Docker Compose

Optional: curl or wget for flake commands.

---

Setup

With Flakes (Recommended)

1. Clone the repository

git clone <repo-url>
cd <repo-directory>

2. Enter the development shell

nix develop

3. Start/Stop

# Start the full stack in Docker
nix run .#up

# Stop everything
nix run .#down

4. Utils

# Django commands
run            # runserver
migrations     # makemigrations
migrate        # migrate
createapp      # startapp
createadmin    # createsuperuser

# Docker-specific commands
docker-migrations
docker-migrate
docker-createapp
docker-createadmin

# Clean Docker resources
docker-clean-all

Without Flakes

1. Install Dependencies

docker-compose
postgresql
mkcert
python314
uv

2. Start/Stop

# Start the full stack in Docker
docker compose up --build

# Stop everything
docker compose down

3. Utils

docker compose exec django_backend uv run manage.py makemigrations
docker compose exec django_backend uv run manage.py migrate --no-input
docker compose exec django_backend uv run manage.py startapp
docker compose exec django_backend uv run manage.py createsuperuser