Django project template that we use at Thorgate.
Best suited for medium-sized and bigger apps that use JavaScript and React for frontend.
See also the Single-Page Application and Bootstrap 3 variants.
(note that the primary repo is in Gitlab, with mirror in Github)
-
Django-based backend
- Django 1.11 (because it's LTS)
- Separate settings for different environments (local/staging/production)
- Python 3.4 / 3.5 / 3.6
-
Frontend app with JavaScript (ES2015), React and Sass
-
Batteries
- Docker / Docker Compose integration
- Linting of Python, JavaScript and Sass code with Prospector, ESLint and stylelint
- py.test and coverage integration
- Deploy helpers, using Fabric
- Media files are stored in a CDN like S3 or Google Cloud Storage
- Out-of-the-box configuration for nginx, gunicorn and logrotate
- Includes PyCharm project config
To use this template, first ensure that you have
Pipenv 2018.11.26
available.
After that, you should:
-
Install the requirements of the project template by running
pipenv install
-
Activate the virtualenv created by pipenv:
pipenv shell
-
Navigate to the directory where you'd like to create your project:
cd /home/my-awesome-projects/
-
Create a new project by executing:
cookiecutter dir/to/django-project-template/
It will ask you a few questions, e.g. project's name.
After generation completes, you should deactivate virtual environment for cookiecutter, search for any TODOs in the code and make appropriate changes where needed.
See README.md in the generated project for instructions on how to set up your development environment.
First ensure you have a python3 interpreter with cookiecutter
installed.
To upgrade an existing project, change the current working directory to the root of the project you want to upgrade. i.e. cd project-to-upgrade
. Ensure your are not in the template
branch.
Then run python ~/path/to/django-project-template/upgrade-template.py
This will make a commit to the branch template
in your project with the updates to the project template. Then merge the template
branch.