Django-Bolt

Critical rules

• Always use async handlers unless the user explicitly needs sync
• Use async database access in async handlers (e.g., Django async ORM: aget, acreate, afilter)
• Use msgspec.Struct for simple typed payloads; use Serializer for richer validation and reusable field sets
• Keep route signatures typed -- let Django-Bolt validate inputs instead of hand-parsing request.body
• Use built-in HTTP exceptions (HTTPException) for expected API failures
• Run with python manage.py runbolt --dev for development, not uvicorn or gunicorn

Apply this skill when

• The user mentions django-bolt, BoltAPI, runbolt, Depends, response_model, APIView, JWTAuthentication, OpenAPIConfig, TestClient, WebSocket, StreamingResponse, or SSE
• The user wants to start a Django-Bolt app, add endpoints, wire auth, expose docs, add pagination, return files, streams, or SSE events, or test handlers
• The user wants to migrate from FastAPI, DRF, or Django Ninja -- see references/migration-playbook.md

Do NOT apply when