Skip to content
Go to file

Latest commit

An SSL error occurs for some users especially on macOS. So explicit zip file download step is mentioned in the README.

Git stats


Failed to load latest commit information.

{% comment "This comment section will be deleted in the generated project" %}


Build Status

A Fantastic Django project starter.


  • Ready Bootstrap-themed pages
  • User Registration/Sign up
  • Better Security with 12-Factor recommendations
  • Logging/Debugging Helpers
  • Works on Python 3 and Django 2
  • Formatted with Black

Quick start:

  1. $ startproject --template= --extension=py,md,html,env my_proj
  2. $ cd my_proj
  3. $ pip install -r requirements.txt
  4. $ cd src
  5. $ cp my_proj/settings/local.sample.env my_proj/settings/local.env
  6. $ python migrate

More information at: Contribute using: Edge Dev Tools 🍰

Recommended Installation (with pipenv)

  1. $ pip install --user --upgrade pipenv (Install pipenv system-wide or locally but outside a virtualenv)

  2. $ mkdir my_proj (choose a better name than my_proj for your project)

  3. $ startproject --template= --extension=py,md,html,env my_proj .

    If you get an SSL error, then download the zip file and mention it after --template=, like this: startproject --template=~/Downloads/ --extension=py,md,html,env my_proj .

  4. $ pipenv install --dev

  5. $ pipenv shell

  6. $ cp src/my_proj/settings/local.sample.env src/my_proj/settings/local.env (or rename this file)

  7. $ cd src

  8. $ python migrate

  9. $ python createsuperuser

  10. $ python runserver

If you need to keep requirements.txt updated then run

pipenv lock --requirements > requirements/base.txt
echo "-r base.txt" > requirements/development.txt
pipenv lock --requirements --dev >> requirements/development.txt

Rest of this README will be copied to the generated project.

{% endcomment %}

{{ project_name }}

{{ project_name }} is a short description. It is built with Python using the Django Web Framework.

This project has the following basic apps:

  • App1 (short desc)
  • App2 (short desc)
  • App3 (short desc)


Quick start

To set up a development environment quickly, first install Python 3. It comes with virtualenv built-in. So create a virtual env by:

1. `$ python3 -m venv {{ project_name }}`
2. `$ . {{ project_name }}/bin/activate`

Install all dependencies:

pip install -r requirements.txt

Run migrations:

python migrate

Detailed instructions

Take a look at the docs for more information.

You can’t perform that action at this time.