cookiecutter/cookiecutter-django is a Developer Tools project on GitHub, written primarily in Python. It has 13.6k stars. Cookiecutter Django is a framework for jumpstarting production-ready Django projects quickly.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
See Troubleshooting for common errors and obstacles
If you have problems with Cookiecutter Django, please open issues don't send
emails to the maintainers.
Features
For Django 6.0
Works with Python 3.14
Renders Django projects with 100% starting test coverage
Twitter Bootstrap v5
12-Factor based settings via django-environ
Secure by default. We believe in SSL.
Optimized development and production settings
Registration via django-allauth
Comes with custom user model ready to go
Optional basic ASGI setup for Websockets
Optional custom static build using Gulp or Webpack
Send emails via Anymail (using Mailgun by default or Amazon SES if AWS is selected cloud provider, but switchable)
Media storage using Amazon S3, Google Cloud Storage, Azure Storage or nginx
Docker support using docker-compose for development and production (using Traefik with LetsEncrypt support)
Procfile for deploying to Heroku
Instructions for deploying to PythonAnywhere
Run tests with unittest or pytest
Customizable PostgreSQL version
Default integration with pre-commit for identifying simple issues before submission to code review
Optional Integrations
These features can be enabled during initial project setup.
Serve static files from Amazon S3, Google Cloud Storage, Azure Storage or Whitenoise
Configuration for Celery and Flower (the latter in Docker setup only)
Integration with Mailpit or Mailtrap Local for local email testing
Integration with Sentry for error logging
Constraints
Only maintained 3rd party libraries are used.
Uses PostgreSQL everywhere: 14 - 18 (MySQL fork also available).
Environment variables for configuration (This won't work with Apache/mod_wsgi).
Support this Project!
This project is an open source project run by volunteers. You can sponsor us via OpenCollective or individually via GitHub Sponsors:
Daniel Roy Greenfeld, Project Lead (GitHub, Patreon): expertise in Django and AWS ELB.
Fabio C. Barrionuevo, Core Developer (GitHub): expertise in Python/Django, hands-on DevOps and frontend experience.
Bruno Alla, Core Developer (GitHub): expertise in Python/Django and DevOps.
Nikita Shupeyko, Core Developer (GitHub): expertise in Python/Django, hands-on DevOps and frontend experience.
Projects that provide financial support to the maintainers:
Two Scoops of Django
Two Scoops of Django 3.x is the best ice cream-themed Django reference in the universe!
PyUp
PyUp brings you automated security and dependency updates used by Google and other organizations. Free for open source projects!
Usage
Let's pretend you want to create a Django project called "redditclone". Rather than using startproject
and then editing the results to include your name, email, and various configuration issues that always get forgotten until the worst possible moment, get cookiecutter to do all the work.
Now take a look at your repo. Don't forget to carefully look at the generated README. Awesome, right?
For local development, see the following:
Developing locally
Developing locally using docker
Community
Have questions? Before you ask questions anywhere else, please post your question on Stack Overflow under the cookiecutter-django tag. We check there periodically for questions.
If you think you found a bug or want to request a feature, please open an issue.
For anything else, you can chat with us on Discord.
For Readers of Two Scoops of Django
You may notice that some elements of this project do not exactly match what we describe in chapter 3. The reason for that is this project, amongst other things, serves as a test bed for trying out new ideas and concepts. Sometimes they work, sometimes they don't, but the end result is that it won't necessarily match precisely what is described in the book I co-authored.
For PyUp Users
If you are using PyUp to keep your dependencies updated and secure, use the code cookiecutter during checkout to get 15% off every month.
"Your Stuff"
Scattered throughout the Python and HTML of this project are places marked with "your stuff". This is where third-party libraries are to be integrated with your project.
For MySQL users
To get full MySQL support in addition to the default Postgresql, you can use this fork of the cookiecutter-django:
https://github.com/mabdullahadeel/cookiecutter-django-mysql
Releases
Need a stable release? You can find them at https://github.com/cookiecutter/cookiecutter-django/releases
Not Exactly What You Want?
This is what I want. It might not be what you want. Don't worry, you have options:
Fork This
If you have differences in your preferred setup, I encourage you to fork this to create your own version.
Once you have your fork working, let me know and I'll add it to a 'Similar Cookiecutter Templates' list here.
It's up to you whether to rename your fork.
If you do rename your fork, I encourage you to submit it to the following places:
cookiecutter so it gets listed in the README as a template.
The cookiecutter grid on Django Packages.
Submit a Pull Request
We accept pull requests if they're small, atomic, and make our own project development
experience better.
Articles
Why cookiecutter-django is Essential for Your Next Django Project - Aug. 4, 2024
How to Make Your Own Django Cookiecutter Template! - Aug. 10, 2023
Cookiecutter Django With Amazon RDS - Apr, 2, 2021
Complete Walkthrough: Blue/Green Deployment to AWS ECS using GitHub actions - June 10, 2020
Using cookiecutter-django with Google Cloud Storage - Mar. 12, 2019
cookiecutter-django with Nginx, Route 53 and ELB - Feb. 12, 2018
cookiecutter-django and Amazon RDS - Feb. 7, 2018
Using Cookiecutter to Jumpstart a Django Project on Windows with PyCharm - May 19, 2017
Exploring with Cookiecutter - Dec. 3, 2016
Introduction to Cookiecutter-Django - Feb. 19, 2016
Django and GitLab - Running Continuous Integration and tests with your FREE account - May. 11, 2016
Development and Deployment of Cookiecutter-Django on Fedora - Jan. 18, 2016
Development and Deployment of Cookiecutter-Django via Docker - Dec. 29, 2015
How to create a Django Application using Cookiecutter and Django 1.8 - Sept. 12, 2015
Have a blog or online publication? Write about your cookiecutter-django tips and tricks, then send us a pull request with the link.
How active is development on cookiecutter/cookiecutter-django?
The most recent commit recorded on cookiecutter/cookiecutter-django was 3 months ago, based on the GitHub push timestamp. The repository has 3.1k forks — one of the better signals of community interest.
Is cookiecutter/cookiecutter-django open source?
Yes — cookiecutter/cookiecutter-django ships under the BSD-3-Clause license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/cookiecutter/cookiecutter-django.
What license does cookiecutter/cookiecutter-django use?
cookiecutter/cookiecutter-django is released under the BSD-3-Clause license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is cookiecutter/cookiecutter-django associated with?
Where can I see cookiecutter/cookiecutter-django in action?
The project maintains a homepage at https://cookiecutter-django.readthedocs.io. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about cookiecutter/cookiecutter-django?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/cookiecutter/cookiecutter-django is the definitive source.
Read full README in the tab above.
Curious whether cookiecutter-django is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about cookiecutter-django.