A production-ready Django SPA app on Heroku in 20-min or less!

Example deployment (main branch)

First, get cookiecutter, as detailed in the official documentation.

Now run it against this repo:

cookiecutter [email protected]:thinknimble/tn-spa-bootstrapper.git

See: Maintained Foundation fork

• For Django 3.1
• Uses Python 3.10 by default
• Renders Django projects with 100% starting test coverage
• Secure by default. We believe in SSL.
• Optimized development and production settings
• Comes with custom user model ready to go
• Optional basic ASGI setup for Websockets
• Optional basic Django channel setup for Websockets
• Optional client side applications Vue or React
• Send emails using Mailgun by default or Amazon SES if AWS is selected cloud provider.
• Media storage using Amazon S3 or Google Cloud Storage
• Procfile for deploying to Heroku
• Run tests with unittest or pytest
• Default integration with pre-commit for identifying simple issues before submission to code review
• Integration with Rollbar for error logging

These features can be enabled after initial project setup:

• Serve static files from Amazon S3 or Whitenoise
• Integration with MailHog for local email testing

Let's pretend you want to create a Django project called "therock". 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.

Follow the Quick Start above.

You'll be prompted for some values. Provide them, then a Django project will be created for you.

Answer the prompts with your own desired options. For example:

project_name [My Project]: The Rock
author_name [ThinkNimble]: Test Author
email [[email protected]]: [email protected]
project_slug [the_rock]:
Select mail_service:
1 - Mailgun
2 - Amazon SES
3 - Custom SMTP
Choose from 1, 2, 3 [1]: 1
Select client_app:
1 - Vue3
2 - React
3 - None
Choose from 1, 2, 3 [1]: 1
Error: "my_project" directory already exists
william@Williams-MacBook-Pro thinknimble % rm -rf my_project 
william@Williams-MacBook-Pro thinknimble % cookiecutter [email protected]:thinknimble/tn-spa-cookiecutter.git --checkout cleanup
You've downloaded /Users/william/.cookiecutters/tn-spa-cookiecutter before. Is it okay to delete and re-download it? [yes]: 
project_name [My Project]: 
author_name [ThinkNimble]: 
email [[email protected]]: 
project_slug [my_project]: 
Select mail_service:
1 - Mailgun
2 - Amazon SES
3 - Custom SMTP
Choose from 1, 2, 3 [1]: 
Select client_app:
1 - Vue3
2 - None
Choose from 1, 2 [1]: 

Create a git repo and push it there::

git init
git add .
git commit -m "first awesome commit"
git remote set-url origin [email protected]:thinknimble/the-rock.git
git push -u origin main 

Now take a look at your repo. Don't forget to carefully look at the generated README. Awesome, right?

See the CONTRIBUTING file for information about reporting issues, setting up your dev environment, running tests, and making pull requests.