- Install VS Code with dev container support.
- Open the project in VS Code, then run
Dev Containers: Reopen in Containerfrom the Command Palette (Ctrl+Shift+P). - Once the container is ready, open a terminal and run:
./manage.py migrate ./manage.py createsuperuser
Open the Run and Debug panel (Ctrl+Shift+D) and select a launch configuration:
- Django: Server - Starts the development server at http://localhost:8000/
- Django: Server (eager Celery) - Same, but Celery tasks run synchronously in the web process (useful for debugging task code without a worker)
- Celery: Worker - Starts only the Celery worker
- Django + Celery - Starts both the server and a Celery worker
- Django: Management Command - Pick and run any management command
Run the full test suite from a terminal: tox
Auto-format code: tox -e format
Run and debug individual tests from the Testing panel (Ctrl+Shift+;).
After changes to the Dockerfile, Docker Compose files, or devcontainer.json,
run Dev Containers: Rebuild Container from the Command Palette (Ctrl+Shift+P).
For dependency changes in pyproject.toml, just run uv sync --all-extras --all-groups.