Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

BeDjango starter skeleton

An easy to use project template for Django 1.11, for more information visit our blog

Build Status Coverage Status Codacy Badge


  • High code coverage
  • Custom theme and responsive based on bootstrap
  • Usefull packages
  • Default views
  • User control system
  • Modularity of the applications
  • Application ready for intenationalization
  • Python2/3 compatibility
  • Different utils (Decorators, breadcrumbs..)
  • PO files web editor provided by django-rosetta
  • Cookies adapted to EU Commision standards.


What things you need to use this starter and how to install them:

  • Git (if you are going to clone this project):
 sudo apt install git
  • Pip:
 sudo apt install python-pip
  • Virtualenv:
 sudo pip install virtualenv
  • Python3-dev:
 sudo apt install python3-dev

How to use it

The following steps have been created based on a ubuntu 16 using python3.5. To create a new application using this starter, you must do the following steps

# Create virtualenv
virtualenv -p python3 venv

# Activate virtualenv and install Django
source venv/bin/activate
pip install django==1.11

Use django-admin to create the app using the starter startproject --template= --extension=py,rst,yml {{nameofproject}}

# Install requirements/dev-requirements
cd nameofproject/nameofproject
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Migrate database 
python3 migrate

# Compile translations
python3 compilemessages

# To run our project:
python3 runserver

Now your app is running at localhost

Other commands

# Create superuser (Password must be at least 8 characters and contain letters, numbers and special characters !-·$%/()=?)
python3 createsuperuser

# You can create a project from a local template
git clone startproject --template=bedjango-starter/project_name --extension=py,rst,yml {{nameofproject}}

# If we need to create a new app inside our project, we must clone this repo and run following command: startapp --template=bedjango-starter/project_name/project_name --extension=py,rst,yml {{nameofapp}}


To run tests we must run the following command:

coverage run --source='.' test --settings base.test_settings

# To get a coverage report
coverage report -m

Packages included


This project is licensed under the MIT License