(formerly known as django-cookiecutter)

Project template for django based projects, optimized for making REST API with deployment on Heroku and EC2 instances.

• Django 1.9.x
• PostresSQL everywhere(support of postgis is available).
• Procfile for deploying to Heroku.
• Ansible script for quick deployment to Ubuntu based servers.
• 12-Factor based settings management via django-environ, reads settings from .env if present.
• Designed to work with Django Rest Framework 3.0+.
• Uses django_sites instead of django.contrib.sites
• Use mkdocs for project documentation.
• Uses py.test as test runner.
• travis.yml for running isolated tests and deployments to dev/qa/prod environment on Heroku from git branches.
• Custom User app, for easier extensibility.
• Optional media storage using Amazon S3
• Livereloading of browser in development via devrecargar
• robots.txt and humans.txt configured

Install cookiecutter with brew install cookiecutter or pip install cookiecutter.

cookiecutter gh:Fueled/django-init

It will ask you couple of questions required to generate the project. It will generate a folder containing all the files in your current working directory.

If you opt to setup the project automatically, it will also:

• initialize a git repo and bump initial tag and version.
• create a virtualenv in the folder venv inside the project.
• install all the python dependencies inside it.
• try to create a postgres database and run the initial migration against it.

then only thing you'll need to do is:

1. cd into the new github_repository folder just created.
2. Activate virtualenv source venv/bin/activate.
3. Run fab serve or ./manage.py runserver

Don't forget to carefully look at the generated README. Awesome, right?

You can also explore the wiki section for details on advance setups and usuages.

Refer to CHANGELOG.md.

Built with ♥ at Fueled