A Django 1.8 base template with HTML5Boilerplate and Twitter Bootstrap
Python HTML CSS Nginx Shell JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
base We now fully support django 1.7. Sep 17, 2014
bin Replaced deprecated module commands with subprocess. Mar 4, 2015
conf The configuration of the nginx is wrong Aug 8, 2012
db Make bcrypt the default hashing algorithm and upgrade to django-debug… Feb 23, 2012
docs Rename some things and move others around a bit. Going to clean up se… Mar 13, 2013
lib Move fabfile.py, and make it awesomer. This hasn't been tested yet. May 24, 2012
media Forgot to add the media directory. Mar 9, 2012
project_name little fix for Python 3 Jan 30, 2015
requirements Some updates for Django 1.8, mainly just bumping the version in the R… Aug 31, 2015
static A bit of cleanup. Remove some extranous code that, although you will … Mar 9, 2012
.gitignore Rename some things and move others around a bit. Going to clean up se… Mar 13, 2013
LICENSE Getting started on updating the template to Django 1.5. The Django 1.… Mar 12, 2013
README.md Oops, Django 1.8 no longer supports Python 2.6. 2.7 is a minimum, 3.4… Aug 31, 2015
Vagrantfile added simple provisioning to install from pip requirements file Dec 3, 2013
fabfile.py A last tiny amount of cleanup, and delete the unneeded extra fabfile.py. Mar 15, 2013
install_requirements.sh added simple provisioning to install from pip requirements file Dec 3, 2013
manage.py Add in a bunch of missing settings stuff, and cleanup some mistakes. Feb 23, 2012
requirements.txt Rename some things and move others around a bit. Going to clean up se… Mar 13, 2013


{% if False %}

Django 1.8 Base Template


This template is based off of the work of Mozilla Playdoh and Two Scoops of Django, as well as experience with other Django layouts/project templates. Playdoh is mainly setup for Mozilla's systems and is overly-complicated for a simple project template. (Though it does provide some very good real-world use examples.)

This project template is designed for Django startproject template option. This version of the project template is designed for Django 1.8.

As much as I could, all the code has been updated to use the any suggested layouts and functionality in Django 1.8.


By default, this project template includes:

A set of basic templates built from HTML5Boilerplate 4.1.0 and Twitter Bootstrap 3.2.0 (located in the base app, with css and javascript loaded from CloudFlare CDN by default).


  • django_compressor for compressing javascript/css/less/sass


  • bleach
  • bcrypt - uses bcrypt for password hashing by default

Background Tasks:

  • Celery


  • Django built-in migrations


  • python-memcached


  • Includes django-debug-toolbar for development and production (enabled for superusers)


  • nose and django-nose
  • pylint, pep8, and coverage

Any of these options can added, modified, or removed as you like after creating your project.

How to use this project template to create your project

  • Create your working environment and virtualenv
  • Make sure you have libffi installed ($ sudo apt-get install libffi-dev)
  • Install Django 1.8 ($ pip install Django>=1.8)
  • $ django-admin.py startproject --template https://github.com/xenith/django-base-template/zipball/master --extension py,md,rst projectname
  • $ cd projectname
  • Uncomment your preferred database adapter in requirements/compiled.txt (MySQL, Postgresql, or skip this step to stick with SQLite)
  • $ pip install -r requirements/local.txt
  • $ cp projectname/settings/local-dist.py projectname/settings/local.py
  • $ python manage.py syncdb
  • $ python manage.py migrate
  • $ python manage.py runserver

That's all you need to do to get the project ready for development. When you deploy your project into production, you should look into getting certain settings from environment variables or other external sources. (See SECRET_KEY for an example.)

There isn't a need to add settings/local.py to your source control, but there are multiple schools of thought on this. The method I use here is an example where each developer has their own settings/local.py with machine-specific settings. You will also need to create a version of settings/local.py for use in production that you will put into place with your deployment system (Fabric, chef, puppet, etc).

The second school of thought is that all settings should be versioned, so that as much of the code/settings as possible is the same across all developers and test/production servers. If you prefer this method, then make sure all necessary settings are properly set in settings/base.py, and then edit settings/init.py so it no longer reraises the exception. (ie, by replacing 'raise' with 'pass'). As it is, settings/local.py should only be overriding settings from settings/base.py anyway. (You could also just set the DJANGO_SETTINGS_MODULE environment variable to "{{ project_name }}.settings.base" directly.)

Python 3 compatibility

All the code provided in the template itself is compatible with Python 3. Unfortunately, there are still a number of libraries that do not work under Python 3. If you want to use this template under Python 3, you will need to either remove those libraries or find replacements for them.

The libraries I am aware of that do not support Python 3:

  • python-memcached (use python3-memcached)

{% endif %}

The {{ project_name|title }} Project


Describe your project here.


  • Python 2.7, 3.4 recommended
  • pip
  • virtualenv (virtualenvwrapper is recommended for use during development)


Fill out with installation instructions for your project.


This software is licensed under the New BSD License. For more information, read the file LICENSE.