If you've ever started a Django + Inertia.js project from scratch, you know the pain. There are dozens of configuration files to set up, environment variables to manage, build tools to configure, and boilerplate code to write before you can even start building features.
What should take minutes often takes hours.
create-django-inertia solves this problem by automating the entire project scaffolding process — similar to create-react-app or npm create vite, but built specifically for modern Django + Inertia.js full-stack applications.
What Is create-django-inertia?
create-django-inertia is a powerful CLI tool that generates a complete, production-ready Django + Inertia.js project structure in seconds.
You can choose your preferred frontend framework — React 18 or Vue 3 — and optionally enable TypeScript. The tool handles all the tedious setup so you can focus immediately on building features.
Think of it as a starter kit generator: run one command, answer a few questions (or use CLI flags), and get a fully configured development environment with modern tooling and a beautiful landing page.
The Manual Setup Problem
Before create-django-inertia existed, starting a Django + Inertia project meant:
Backend Setup
- Creating a Django project from scratch
- Installing and configuring inertia-django
- Setting up middleware and settings
- Configuring static files for Vite
- Handling CSRF tokens correctly
- Creating example Inertia views
- Setting up shared props
Frontend Setup
- Installing React 18 or Vue 3
- Configuring Vite 6.0
- Setting up Inertia component resolvers
- Creating the app entry point
- Configuring asset management
- Deciding TypeScript setup
Styling & Design
- Installing Tailwind CSS v4
- Configuring PostCSS
- Building a design system
Integration
- Serving Vite assets from Django
- Hot Module Reloading (HMR)
- Static files handling for production
- Layout and initial pages
- Environment variable management
For Django developers new to modern JS tooling, this is overwhelming. For full-stack developers, it’s repetitive busywork. For startups, it’s wasted time.
The create-django-inertia Solution
With create-django-inertia, everything above happens in one command:
pip install create-django-inertia
create-django-inertia myprojectAnswer a few prompts (or pass flags) and you get a fully configured, production-ready project.
Installation Options
Interactive Setup
create-django-inertia myprojectCommand-Line Flags
# React with TypeScript
create-django-inertia myproject --react --typescript
# Vue 3 with TypeScript
create-django-inertia myproject --vue --typescript
# React without TypeScript
create-django-inertia myproject --react
# Vue without TypeScript
create-django-inertia myproject --vue
# Create in current directory
create-django-inertia myproject . --react
# Force overwrite
create-django-inertia myproject --react --force
# Skip installation
create-django-inertia myproject --vue --no-installA Complete Project Structure
myproject/
├── manage.py
├── requirements.txt
├── package.json
├── vite.config.ts
├── tsconfig.json
├── .gitignore
│
├── myproject/
│ ├── settings.py
│ ├── urls.py
│ ├── views.py
│ ├── wsgi.py
│ └── asgi.py
│
├── home/
│ ├── views.py
│ ├── urls.py
│ ├── models.py
│ └── migrations/
│
├── templates/
│ └── base.html
│
├── static/
│ ├── components/
│ ├── pages/
│ ├── css/
│ ├── lib/
│ └── main.tsx
│
└── media/What You Get Pre-Configured
Django Backend
- Django 4.2+
- Inertia middleware & configuration
- Admin enabled
- Static file setup for Vite
- CSRF protection
Frontend (React or Vue)
- React 18 or Vue 3
- Optional TypeScript
- Vite 6.0
- Tailwind CSS v4 (OKLCH)
- HMR
- Production build optimization
Who This Is For
- Django developers exploring modern frontends
- Full-stack Django + React/Vue teams
- Startups & agencies
- Teams needing consistent scaffolding
- Anyone tired of repetitive setup
Learn More
- GitHub Repository
- PyPI Package
- Inertia.js Documentation
- Django Documentation
- React Documentation
- Vue 3 Documentation
- Vite Documentation
Happy coding 🚀