Interbase league is a popular football festival based in Nairobi Kibera to be specific. The software acts as a catalyst to ensure the league runs smoothly and thus captures every tiny details.
Django project template that we use at KICINCO.
Best suited for medium-sized and bigger apps that use JavaScript and React for frontend or single page web applications.
-
Django-based backend
- Django
- Separate settings for different environments (local/staging/production)
- Python 3.6 or later
- [SPA] Accessible from port
:8000for local development - PostgreSQL - Structured database design for clean data fetch
-
Frontend app with JavaScript (ES2015), React and SaaS
-
Configs & Run
- Docker / Docker Compose integration
- Linting of Python, JavaScript and Sass code with Prospector, ESLint and stylelint
- Automated code-formatting using black and prettier
- py.test and coverage integration
- Deploy helpers, using Ansible
- 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 | VSCode project config and cod formatter
To use this template, first ensure that you have Django available and installed.
After that, you should:
- Install the requirements of the project template by running
pip3 -m venv env - Activate the virtualenv
source ./env/bin/activate - Navigate to the directory where you'd like to create your project:
cd /home/project_directory/ - Run the following command to install all project packages and dependencies
pip install -r requirements.txt - Once the virtual directory is activates, run
python manage.py runserver (localhost:8000)
See README.md in the generated project for instructions on how to set up your development environment.
Isomorphic Javascript single-page application rendered with node and backed by Django Rest Framework. Enabled with frontend_style == spa.
During development and production separate node container is used to run and serve assets if needed.
Translations are done with i18next and its companion library for React.
React powered application rendered with Django templates. This is the default option. Enabled with frontend_style == webapp.
During development separate container is used to build assets. In production, node built with multi-stage image.
Translations are done with Django JavaScriptCatalog.
First ensure you have a python3 interpreter with django 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 have not checked out 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.
First activate Python 3 interpreter with required dependencies and ensure docker is installed and working.
Change the current working directory to the root of the project you want to apply codemods for. i.e. cd project-to-upgrade.
Then run python ~/path/to/django-project-template/upgrade-template.py --apply-frontend-codemods
This will build custom docker image to update old frontend versions.
The template uses our own images for CI runs. One for the template itself and a second one for generated projects. Both images are alpine based and contain python3, pip and some support packages. The images are published to repository container registry and also to docker hub.
The images are built in CI (from default branches only) and also updated every day via schedules.
Project CI Image
- Dockerfile-ci
- Image in repository registry:
registry.gitlab.com/thorgate-public/django-project-template/ci - Image in docker hub:
thorgate/django-template-ci
Template CI Image:
- Dockerfile-base-ci
- Image in repository registry:
registry.gitlab.com/thorgate-public/django-project-template/base-ci - Image in docker hub:
thorgate/django-template-base-ci