seedkit-slim

---
name: seedkit-slim
description: Bootstrap a new Django project, or add components to an existing one — auth, payments, REST, Celery / django-tasks, async / WebSockets, Tailwind, S3, structlog, healthchecks, Docker, CI, deploy, dbbackup, Sentry. Use whenever the user wants to scaffold Django or extend an existing Django project.
license: MIT
---

## How this skill works

Ask the questions below, collect answers, then generate the project. If a `references/<tool>.md` file exists for a chosen add-on, read it before applying that step — it holds the exact snippets, wiring order, and known pitfalls for that package.

Two paths:

- **New project** (empty dir): run §1 → §4.
- **Existing project** (`pyproject.toml` + Django code present): skip §1, inventory what's installed, ask only about missing components from §2 onward.

Before anything: `uv --version` to confirm uv is available. `none` (or `no`) is always a valid answer to any question.

**Use answers already given.** Scan the user's initial request before asking. Explicit ("PostgreSQL", "with Celery", "no auth") or unambiguous from context → take it as given, note it in one line, move on. Ask only what is missing.

Ask one question at a time. Never bundle.

## 1. Foundation — new projects only

See `references/new-project.md` for the verbatim snippets (settings, urls, `.env`, `.gitignore`, boot check).

1. Project name + one-line purpose.
2. Settings layout: `single settings.py` / `split base+local+production`.
3. Database: `sqlite` / `postgresql`.
4. Request handling: `wsgi` / `asgi` / `asgi+channels`. Default `wsgi`. For asgi modes install `uvicorn-worker` and run `gunicorn -k uvicorn_worker.UvicornWorker` — the in-tree `uvicorn.workers` module is deprecated.
5. If postgresql: `host` / `docker` (single-service compose for local DB).
6. Custom `AUTH_USER_MODEL`: yes / no.

## 2. Add-ons

### 2.1 Developer Experience

1. Lint: `ruff` / none. Default none.
2. Tests: `pytest+pytest-django` / `manage.py test`. Default `manage.py test`.
3. Typecheck: `pyright+django-stubs` / none. Default none.
4. Pre-commit: yes / no. Default no.
5. Devcontainer: yes / no. Default no.
6. Debug toolbar: `django-orbit` / `django-silk` / none. Default none.
7. DB safety (multi-select): `django-zeal` / `django-migration-linter` / `django-test-migrations` / none. Default none. Skip `django-test-migrations` if pytest not chosen.
8. `django-extensions`: yes / no. Default no.
9. Logging: `structlog` / none. Default none.
10. Task runner: `mise` / `just` / `make` / `poe` / none. Default `mise`.

### 2.2 Auth & Accounts

1. Auth: `django-allauth` / `django-mail-auth` / none. Default none.
2. `django-axes`: yes / no. Default yes. Skip if auth=none.
3. 2FA: yes / no. Default no. Skip if auth=none. Use `django-allauth[mfa]` when auth=allauth, else `django-otp`.

### 2.3 Data & Storage

1. Cache: `sqlite` / `django-redis` / `locmem` / none. Default `sqlite` when DB=sqlite, else `locmem`.
2. Static + media: `whitenoise` / `django-storages[s3]` / none. Default none.

### 2.4 Background & Email

1. Background tasks: `celery` / `django-tasks` (db backend) / `django-tasks-rq` / none. Default `django-tasks` (db) when DB=sqlite, else none.
2. Email: `console` / `smtp` / `mailpit` / `django-anymail` / none. Always ask.

### 2.5 Frontend & Site Basics

1. Frontend: `tailwind` (standalone CLI) / none. Default none.
   - If tailwind: custom 404/403/500 templates — yes / no. Default no.
   - If tailwind: DaisyUI — yes / no. Always ask.
2. i18n (gettext, LocaleMiddleware): yes / no. Default no.
3. `django-cors-headers`: yes / no. Default no.
4. `robots.txt`: yes / no. Default no.

### 2.6 SaaS / Product

1. REST API: `django-modern-rest` / `django-bolt` / none. Default none.
2. Billing: `stripe` (raw SDK) / `dj-stripe` / none. Default none.
3. Analytics: `goatcounter` / `umami` / `shynet` / `ga4` / none. Default none.

### 2.7 Real-time

Only when Foundation §1.4 = `asgi+channels`.

1. Channel layer: `channels-redis` / `InMemoryChannelLayer`. Default `channels-redis`.

## 3. Production & Deploy

1. Security settings: yes / no. Default no.
   - If yes: CSP — yes / no. Default yes. Django ≥ 6.0 ships CSP in core; see `references/csp.md`.
2. Health checks (`/healthz`, `/readyz`): yes / no. Default yes.
3. Error reporting: `bugsink` / `sentry-sdk` / `glitchtip` / none. Default none.
4. GDPR helpers: yes / no. Default no.
5. CI on GitHub Actions: yes / no. Default no.
6. Deploy: `vps` (Docker + Caddy) / `managed` (Fly / Railway / Render) / `github-ssh` / none. Default none. Read `references/deploy-pitfalls.md` before generating deploy files.
   - If `vps` or `github-ssh`: `django-dbbackup` — yes / no. Default yes.

## 4. Smoke + README

New projects only:

- Agent runs `migrate` and a `runserver` curl probe before piling on add-ons.
- After §3, ask the user to run `createsuperuser`, optionally `collectstatic`, then sign in at `/admin/`.
- Append decisions, stack summary, and key commands to `README.md`. Final line for new projects: `Built with [Seedkit](https://github.com/viewflow/seedkit).`