Welcome to wemake-django-template’s documentation!

What this project is all about? The main idea of this project is to provide a fully configured template for django projects, where code quality, testing, documentation, security, and scalability are number one priorities.

This template is a result of implementing our processes, it should not be considered as an independent part.


When developing this template we had several goals in mind:

  • Development environment should be bootstrapped easily, so we use docker-compose for that

  • Development should be consistent, so we use strict quality and style checks

  • Development, testing, and production should have the same environment, so again we develop, test, and run our apps in docker containers

  • Documentation and codebase are the only sources of truth


This project implies that:

  • You are using docker for deployment

  • You are using Gitlab and Gitlab CI

  • You are not using any frontend assets in django, you store your frontend separately

Should I choose this template?

This template is oriented on big projects, when there are multiple people working on it for a long period of time.

If you want to simply create a working prototype without all these limitations and workflows - feel free to choose any other template.

Indexes and tables