starter-django

A minimal Django project: the default startproject layout, one app, one page, and the default SQLite database.

Getting started

Dependencies are managed with uv.

uv sync
uv run python manage.py migrate
uv run python manage.py runserver

Open http://127.0.0.1:8000 to see the home page. It is rendered by pages.views.home from pages/templates/pages/home.html — edit either and reload.

The admin site is at /admin/; it needs an account:

uv run python manage.py createsuperuser

Tests

uv run python manage.py test

Linting

uv run ruff check .
uv run ruff format --check .

Layout

• config/ — settings, root URLconf, WSGI and ASGI entry points
• pages/ — the app: one view, one template, one test
• manage.py — Django's management CLI

migrate creates db.sqlite3 in the project root. Only Django's own tables live there so far; the app has no models yet.