django-reference-implementation

A highly opinionated, production-ready, 12-factor boilerplate template for Django Projects.

dockerboilerplatedjangoboilerplate-templatepostgresqls3reference-implementation12-factor

Preview

django-reference-implementation preview

Overview

This is a production-ready Django template for building SaaS applications with built-in support for multi-tenant organizations, user invitations and authentication. The stack includes Django, PostgreSQL, Bootstrap 5 and django-allauth, designed for quick deployment to platforms like Dokku or Heroku while prioritizing code simplicity, minimal dependencies and developer speed over complex abstractions.

Features

multi-tenancyorganizationsuser-invitationsemail-verificationsocial-loginsmfa-2faasynchronous-task-processingdocker-composeadmin-customizationhealth-checkscustom-template-tagsstatic-asset-servings3-storagedark-modeprivacy-policyterms-of-service

Feature Flags

userDashboardauthenticationemailsfileUploadsstorageauthorizationteamsOrgsjobsQueueainotificationscachingformsValidationmultitenancyinvitationsmfasocialAuthadminInterfacehealthChecksdarkMode

Recommended Use Cases

saas-applicationsmulti-tenant-platformsteam-collaboration-toolsproduction-ready-applications

Frontend

bootstraphtmlcss

Backend

djangopythonpostgresql

Auth Providers

emailsocial-loginmfa

Deployment Targets

dockerherokudokku

Payment Providers

None

Quick Facts

โญ Stars
131
๐Ÿด Forks
17
๐Ÿงพ License
mit
๐Ÿ”„ Active
Yes
๐Ÿ•’ Last Commit
2025-09-12T20:20:12.000Z

Stack

Framework
django
Language
python
CSS
bootstrap
Database
postgresql, sqlite
Auth
django-allauth
ORM
django-orm
Testing
pytest
CI
github-actions

Data Layer

Databases
postgresql, sqlite, redis
ORM
django-orm

UI Stack

Styling
bootstrap
Components
bootstrap

Developer Experience

Docker
Yes
Tests
Yes
Quickstart
Yes
env.example
Yes
CI
github-actions

Pricing

Classification
free
Selected
โ€”
Notes
Open source MIT licensed project
Get Started with this Boilerplate