Heroku Django Starter Template

An utterly fantastic project starter template for Django 1.7.

Features

• Production-ready configuration for Static Files, Database Settings, Gunicorn, etc.
• Enhancements to Django's statc file serving functionality via WhiteNoise
• Enhancements to Django's database functionality via django-postgrespool and dj-database-url

How to Use

To use this project, follow these steps:

1. Create your working environment.
2. Install Django ($ pip install django)
3. Create a new project using this template

Creating Your Project

Using this template to create a new Django app is easy::

$ django-admin.py startproject --template=https://github.com/heroku/heroku-django-template/archive/master.zip --name=Procfile helloworld

You can replace helloworld with your desired project name.

Running Locally

In order to test on your local machine, follow these steps:

1. Activate the working environment ('$ source venv/bin/activate')
2. Install all packages from requirements.txt ('$ pip install -r requirements.txt')
3. Run local server ('$ foreman start')

Deployment to Heroku

$ git init
$ git add -A
$ git commit -m 'initial commit'

$ heroku create
$ git push heroku master

$ heroku run python manage.py syncdb

Further Reading

• Gunicorn
• WhiteNoise
• django-postgrespool
• dj-database-url