Django SaaS Boilerplate

The open-source Django starter kit for building SaaS applications. Auth, payments, dashboard, and deployment — all wired up.

---

What's included

• Custom user model — email-only login, no username
• Authentication — signup, login, email verification, password reset (django-allauth)
• Stripe subscriptions — Payment Methods API, webhooks, subscription status tracking
• User dashboard — sidebar nav, profile, settings, notification preferences, API keys
• Subscription plans — admin-managed plans with trial support
• Background tasks — Django 6.0 native @task() decorator, no Celery needed
• Content Security Policy — Django 6.0 built-in CSP middleware with nonces
• Template partials — Django 6.0 {% partialdef %} for reusable components
• Security headers — HSTS, SSL redirect, secure cookies (auto-enabled in production)
• PostgreSQL support — DATABASE_URL with SQLite fallback
• Static files — WhiteNoise, no nginx needed
• Deployment — Gunicorn + Procfile, ready for Railway/Heroku/VPS
• Linting — Ruff with Django-specific rules
• 16 tests — landing pages, auth, dashboard, models
• Seed data — one command to populate demo data

Tech stack

Layer	Technology
Backend	Django 6.0, Python 3.12
Auth	django-allauth (email-only)
Payments	Stripe (Payment Methods API)
Frontend	Tailwind CSS (CDN), Alpine.js, HTMX
Database	SQLite (dev) / PostgreSQL (prod)
Static files	WhiteNoise
Server	Gunicorn
Tasks	Django 6.0 native @task()
Linting	Ruff

Quick start

git clone https://github.com/eriktaveras/django-saas-boilerplate.git
cd django-saas-boilerplate
make install
cp .env.example .env
make migrate
python manage.py seed_data
make run

Visit http://localhost:8000 — admin login: admin@example.com / admin123

Commands

Command	Description
make install	Create virtualenv and install dependencies
make run	Start development server
make migrate	Run makemigrations + migrate
make test	Run 16 tests
make seed	Populate demo data (admin + plans)
make lint	Lint with ruff
make format	Format with ruff
make superuser	Create admin user
make clean	Remove pycache files

Project structure

django-saas-boilerplate/
├── core/
│   ├── settings.py           # All config via env vars
│   ├── urls.py               # Root URL routing
│   ├── wsgi.py
│   └── asgi.py
├── apps/
│   ├── accounts/             # CustomUser (email-only), admin
│   │   ├── models.py         # CustomUser + CustomUserManager
│   │   ├── admin.py
│   │   └── tests.py          # 6 tests
│   ├── dashboard/            # Dashboard, profile, settings
│   │   ├── models.py         # SubscriptionPlan, UserSettings
│   │   ├── views.py          # dashboard, profile, settings, plans
│   │   ├── tasks.py          # Background email tasks
│   │   ├── tests.py          # 6 tests
│   │   └── management/commands/seed_data.py
│   ├── subscriptions/        # Stripe integration
│   │   ├── models.py         # StripeCustomer
│   │   └── views.py          # checkout, webhooks
│   └── landing/              # Public pages
│       ├── views.py          # home, features, pricing, robots.txt
│       └── tests.py          # 4 tests
├── templates/
│   ├── base.html             # Public layout (nav + footer)
│   ├── account/              # 20 allauth templates (styled)
│   ├── dashboard/            # Dashboard layout + pages
│   ├── landing/              # Home, features, pricing
│   └── subscriptions/        # Stripe checkout
├── static/css/               # Design system CSS
├── CLAUDE.md                 # AI editor context
├── Makefile                  # Dev commands
├── Procfile                  # Deployment
├── pyproject.toml            # Ruff config
├── requirements.txt
└── .env.example

Environment variables

Copy .env.example to .env and configure:

# Required
DEBUG=True
SECRET_KEY=your-secret-key

# Database (default: SQLite)
# DATABASE_URL=postgres://user:password@localhost:5432/dbname

# Stripe (required for payments)
STRIPE_PUBLIC_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_PRICE_ID=price_...

# Email (default: console backend)
# EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
# EMAIL_HOST=smtp.gmail.com
# EMAIL_PORT=587
# EMAIL_HOST_USER=your-email@gmail.com
# EMAIL_HOST_PASSWORD=your-app-password

Django 6.0 features used

This boilerplate uses three major features introduced in Django 6.0:

Background Tasks — Send emails asynchronously without Celery:

from django.tasks import task

@task
def send_welcome_email(user_email):
    send_mail("Welcome!", "...", None, [user_email])

# In your view:
send_welcome_email.enqueue(user_email=user.email)

Content Security Policy — Built-in CSP middleware with nonce support:

SECURE_CSP = {
    "script-src": [CSP.SELF, CSP.NONCE],
    "style-src": [CSP.SELF, CSP.UNSAFE_INLINE],
}

<script nonce="{{ csp_nonce }}" src="..."></script>

Template Partials — Reusable template components without separate files:

{% partialdef stat_card inline %}
<div class="card">{{ card_title }}: {{ card_value }}</div>
{% endpartialdef %}

{% with card_title="Users" card_value="42" %}
    {% partial stat_card %}
{% endwith %}

Deployment

Railway

Push to GitHub and connect to Railway. The Procfile and DATABASE_URL handling are already configured.

Heroku

heroku create your-app-name
heroku config:set SECRET_KEY=your-secret-key
heroku config:set DEBUG=False
git push heroku main
heroku run python manage.py migrate
heroku run python manage.py seed_data

VPS

pip install -r requirements.txt
python manage.py migrate
python manage.py collectstatic
gunicorn core.wsgi --bind 0.0.0.0:8000

Premium version

Looking for more? DjangoBlaze is the premium version with:

• Teams & multi-tenancy (roles, invitations, team-scoped data)
• AI chat with OpenAI streaming
• Blog with markdown, SEO, and sitemaps
• Google OAuth
• Onboarding wizard
• Admin metrics dashboard (MRR, signups chart)
• 20 slash commands for Claude Code
• 15 AI-friendly documentation guides
• 30 ready-to-use prompts
• 48 passing tests

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License. See LICENSE for details.

Author

Erik Taveras — Full Stack Developer

• eriktaveras.com
• github.com/eriktaveras
• hello@eriktaveras.com

---

Star History