django-starter is prepared buildout environment for django project with reusable and installable django applications in mind.

Using for development

To prepare development environment of your project use this command:


Using for production

To prepare production environment of your project use this command:

make deploy


django-starter provides to different environment, one for development, other for production use.

Environment independent features:

  • Well prepared buildout configuration files.
  • Well prepared Makefile, that lets you do most things just by running make command.
  • South for database migrations.
  • mr.developer lets you add packages to buildout environment directly from source repositories. All major VCS's are supported.

Features in development environment:

  • ctags - you can build tags file from all eggs added to buildout environment.
  • sphinx - django-starter has prepared docs folders for writing documentations using sphinx, sphinx is also included, so you can build documentations just running make html command in docs folder.
  • ipython and ipdb are also included and you will get ipython shell using bin/django shell command. Use import ipdb ; ipdb.set_trace() for excellent ipdb debugger.
  • django-toolbar for inspecting page requests.
  • django-extensions and django-test-utils are also included, these packages provides lots of useful django management commands.
  • pydev .pydevproject file generator for usage with PyDev development environment

Features in production environment:

  • wsgi script out of the box
  • prepared apache configuration file, that can be simply included from apache main configuration with Include /path/to/your/project/etc/apache.conf.
  • MySQL configuration hits.

Project layout

Folder for django project. Here goes only settings and project related templates, urls routing.
Reusable django apps, even if your app directly related to your project and can be reused should be added here.
Fully prepared Sphinx documentation template.
Provides simple and useful command.
Main buildout configuration file. Here comes all environment independent settings.
Buildout configuration file for development environment.
Initial data.
Creates new django app template.

Commands from Makefile:

Prepares development environment and does everything that is needed.
make run
Runs django development web sever.
make tags
Builds tags file from all eggs included in buildout environment.
make test
Runs all unit tests.
make coverage
Generates unit tests code coverage reports.
make syncdb
Removes development database and creates it from scratch.
make graph
Generates graphical representation of your models.
make clean
Cleans some generated files.

How to add new app


Words in python package names are separated with hyphen, but words in python module names are separated with spacing underscores.

Here is example of python package name:


Example of python module name:

  1. Run comand and provide python package name:

    ./ my-app-name
  2. Open buildout.cfg file.

  3. Add apps/my-app-name line in [buildout] section, develop setting:

    develop =
  4. Add my-app-name line in [buildout] section, eggs setting:

    eggs =
  5. Open project/ file.

  6. Add 'my_app_name', line in INSTALLED_APPS tuple.

  7. Run command:

  8. Check if your added app works:

    bin/django shell
    >>> import my_app_name