django-template

A battle-tested Django 2.1 project template with configurations for AWS, Heroku, App Engine, and Docker.

Code Quality Rank: L5

Programming language: Python

Tags: RESTful API     Django     Templates     Provisioning     Setup    

README

[](meta/repo-banner.png) [](meta/repo-banner-bottom.png)

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

{{ project_name }}

Table of Contents

• Requirements
• Local Setup
• Local Development

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". Your project is now running!