v1.0.2 — 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.

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/
├── 📄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
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/