My Django 1.4 Project Template

A custom Django project template with sensible defaults, including git, pip, virtualenv, and more baked in.


Django supports custom project templates as of 1.4. This is a feature I’ve been dreaming of and have since created what I consider, and hope, is an improved project template for most.

https://github.com/amccloud/django-project-skel/

Changes and additions

  • Automatically builds a README with installation notes.
  • Includes a .gitignore for the usual junk.
  • Encourages the use of git.
  • Encourages the use of pip and requirements.txt.
  • Encourages the use of virtualenv and virtualenvwrapper.
  • Encourages the use of local_settings.py and accompanying __local_settings.py template.
  • Discourages storing credentials and secrets in the repository.
  • HTML 5 base template with simple 404 and 500 error templates.
  • Django timezone setting changed to UTC for sanity.
  • Django admin activated by default.
  • Collects static and media into public/{static,media} respectively.
  • Global templates, static, and fixtures directory.

How to use

django-admin.py startproject --template https://github.com/amccloud/django-project-skel/zipball/master --extension py,md yourprojectname

Contribute on GitHub

← All posts