Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tangent's template Django project
Python Makefile HTML Shell
Latest commit d77d3b5 @chrismckinnel chrismckinnel Merge pull request #30 from tangentlabs/update-django-1.7
Update requirements to django 1.7


Tangent Django Boilerplate

This is a boilerplate README.rst created from the tangent-django-boilerplate project. This section should be deleted and the below sections completed when the project is created.

Use this project with Django's startproject command:

$ startproject $PROJECT_NAME \
  --extension="py,rst,conf,wsgi" \

Note that you need to specify a name for the project and pass the following variables:

  • client - The client for this project
  • project_code - The project code
  • domain - The top-level domain for the test/stage sites and the alerts mailing list
  • timezone - Which timezone to use in

Tangent developers can use the tangent-kickstart tool to simplify creation of projects that conform to our conventions:

The below copy contains template variables - it gets merged with a context when a new boilerplate project is created.

Project title

<TODO: Describe the purpose of this project. What problem is it trying to solve.>

<TODO: Describe any third party integrations.>

<TODO: Describe what technologies are used within the project.>

For everyone


<TODO: List mailing lists and any other channels for project communication>


<TODO: Include credentials for 3rd party systems>

For developers

Local installation

Clone repo, create a virtualenv and run:

$ make

which will install dependencies and build a local database. Running:

$ www/ runserver

will serve the site at

<TODO: Describe any further installation instructions>


Run the test suite using either:

$ make test


$ cd www
$ py.test

See the py.test docs for info on how to run subsets of the test suite.

Continuous integration status:

<TODO: Set project up on Travis to get the correct token for the below image>{{client}}_{{project_code}}.png?token=&branch=master


Deployment uses Fabric. There are helper scripts for each environment:

$ ./
$ ./
$ ./


<TODO: Describe the infrastructure for this project, covering webservers, databases and other services (eg Solr, RabbitMQ). Include versions>

<TODO: List the IP addresses of each server used by this project and any HTTP basic auth credentials>


<TODO: Set project up on Zabbix and include URL here>

<TODO: Set project up on Sentry and include URL here>


<TODO: Describe any gotchas or unusual parts of the codebase. Assume the person who will take over this project from you is a serial killer who knows where you live.>

<TODO: Describe the reasoning behind major design decisions>

For testers

<TODO: List information that testers will need to know such as testing bankcard numbers.>

Something went wrong with that request. Please try again.