Skip to content
A battle-tested Django 2.1 project template with configurations for AWS, Heroku, App Engine, and Docker.
Python Shell HTML Makefile Ruby JavaScript
Branch: django-2.1
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app minor bugfixes and dependency updates Mar 4, 2018
conf make minor template updates Mar 19, 2019
git_config add git_config Aug 4, 2015
meta
scripts update database-init Mar 21, 2019
static add autotrack as a dependency Oct 5, 2017
templates update viewport to max device width Oct 5, 2017
.gitignore ignore map files Dec 30, 2017
.ruby-version update ruby-version and Gemfile Feb 14, 2018
Gemfile make minor template updates Mar 19, 2019
Gemfile.lock update ruby-version and Gemfile Feb 14, 2018
Makefile make minor template updates Mar 19, 2019
Procfile.dev update Procfile Feb 13, 2018
README.md Update README.md Mar 19, 2019
__init__.py oops, a few more changes Jul 8, 2011
appspec.yml remove ValidateService Apr 23, 2018
fabfile.py clean up fab deployment May 4, 2017
manage.py Add livereload to template. Jun 26, 2015
requirements.txt bump psycopg2 to 2.7.7 Mar 22, 2019
settings.py remove references to raven as it's been deprecated Mar 13, 2019
urls.py update URLs and pidfile location Feb 13, 2018
wsgi.py 1.7 fixes Sep 7, 2014

README.md

For information on how to use this project template, check out the wiki.

{{ project_name }}

Table of Contents

Requirements

  • Homebrew (not quite a "requirement" but recommended)

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  • Python 3

    brew install python
    
  • pip (should come bundled when installing Python 3 via Homebrew)

  • PostgreSQL 10.4

    brew install postgresql
    

Local Development

  1. Set up the Python virtual environment.

    python3 -m venv venv
    
  2. Run the make setup task. This will install all requirements, link local settings, initialize the local development database, and run all migrations.

    make setup
    
  3. Set up the Git hooks (optional).

    make setup-git-hooks
    
  4. Start the local development server and Sass.

    foreman start -f Procfile.dev
    

    Map "local.{{ project_name }}.com" to 127.0.0.0 using DNS. If you haven't yet registered a domain, add the following line to your /etc/hosts file.

    127.0.0.1 local.{{ project_name }}.com
    

    After you've done that, open your browser and navigate to "[local.{{ project_name }}.com](http://local.{{ project_name }}.com)". Your project is now running!

You can’t perform that action at this time.