v1.1.0 — Now on PyPI

Scaffold Production-Ready Django Projects in Seconds

Skip the boilerplate. Generate fully configured Django projects with your preferred stack — MVP or API, FBV or CBV, SQLite or PostgreSQL — all from a single command.

Python 3.8+
Compatibility
Django 4.2 / 5.0
Framework Support
MIT
Open Source
terminal — django-kickstart
❯

Everything You Need, Nothing You Don't

A thoughtfully curated scaffold that gives you the right foundation without overwhelming you with opinions.

🎯

Two Project Types

Choose MVP for traditional Django with templates or API for a Django REST Framework backend.

🐍

Auto Virtual Environment

Automatically creates a venv and installs all dependencies — no manual setup required after generation.

👁️

View Style Choice

Function-Based Views (FBV) for simplicity or Class-Based Views (CBV) for structure — your call.

🗄️

Database Options

SQLite for quick development or PostgreSQL for production-grade persistence.

🔒

Production Settings

Security-hardened settings with environment variables via python-decouple, ready to deploy.

⚙️

Admin Panel

Django admin enabled and configured out of the box with your models registered.

🔗

URL Routing

Fully wired URLs with admin and your app routes included — zero manual setup.

🎨

Starter Templates

Modern responsive HTML templates with clean CSS for MVP projects. Ready to customize.

🌐

DRF Browsable API

Auto-configured REST Framework with pagination, permissions, and CORS for API projects.

🐳

Docker Support

Optional --docker flag generates a production-ready Dockerfile, docker-compose.yml, .dockerignore, and entrypoint.sh.

Three Steps to Liftoff

From install to running server in under a minute.

1

Install

One pip command. No global configs, no complex setup. Just install and go.

$ pip install django-kickstartx
2

Create

Run the CLI with your project name. Choose your stack interactively or via flags.

$ django-kickstart create myproject
3

Build

Your project is ready. Migrate, create a superuser, and start the dev server.

$ python manage.py runserver

Clean & Organized From the Start

Every file has a purpose. Every path is pre-wired. Switch between MVP and API to see what you get.

mvp-project — tree
📁myproject/
├── �venv/# Auto-created virtual environment
├── �📄manage.py
├── 📄requirements.txt
├── 📄.env.example
├── 📄.gitignore
├── 📁myproject/
│ ├── ⚙️settings.py# Security, DB, static/media config
│ ├── 🔗urls.py# Admin + core app wired
│ ├── 📄wsgi.py
│ └── 📄asgi.py
├── 📁core/
│ ├── ⚙️admin.py# Item model registered
│ ├── 📦models.py# Example Item model
│ ├── 👁️views.py# FBV or CBV
│ ├── 🔗urls.py
│ ├── 📝forms.py# ModelForm
│ ├── 🧪tests.py
│ └── 📁templates/core/
│ ├── 🎨base.html
│ ├── 🏠home.html
│ └── ℹ️about.html
└── 📁static/css/
└── 🎨style.css

Full Control via Flags or Prompts

Use interactive mode for guided setup, or pass flags for automated one-liner project generation.

django-kickstart --help
FlagChoicesDefaultDescription
--type
mvpapi
interactiveMVP (Templates + Views) or API (Django REST Framework)
--views
fbvcbv
interactiveFunction-Based Views or Class-Based Views
--db
sqlitepostgresql
interactiveSQLite for dev or PostgreSQL for production
--no-venv
falseSkip automatic virtual environment creation
--docker
falseAdd Docker setup (Dockerfile, docker-compose.yml, .dockerignore, entrypoint.sh for PostgreSQL)
example — one-liner
❯django-kickstart create myapi --type api --views cbv --db postgresql

Secure by Default

Every project generated by KickstartX follows Django security best practices from the very first line of code.

✓
Auto-Generated SECRET_KEY
Each project gets a unique 50-character cryptographically random key. No shared insecure defaults.
✓
Mandatory SECRET_KEY Check
App fails immediately if SECRET_KEY is not set in environment, preventing silent insecure operation.
✓
Path Traversal Protection
All generated file paths are validated to stay within the project directory.
✓
Overwrite Protection
CLI refuses to overwrite existing project directories, preventing accidental data loss.
✓
Input Validation
Project names are validated against a strict pattern in both CLI and generator.
✓
Production-Ready Security
HSTS, secure cookies, XSS protection, and all 4 Django password validators enabled by default.

Ready to Kickstart Your Next Project?

Install the package and generate your first Django project in under 60 seconds.

getting-started
❯django-kickstart create myproject
📦 Creating virtual environment...
📥 Installing dependencies... done
❯cd myproject
#Windows: venv\Scripts\activate
❯source venv/bin/activate
❯cp .env.example .env
❯python manage.py migrate
❯python manage.py createsuperuser
❯python manage.py runserver
✓ Development server started at http://127.0.0.1:8000/