Jade Truffle is the Mandarin traslation of the cacti species blossfeldia liliputana. The smallest of all cacti.
Jade Truffle is a cookiecutter template designed to generate a greenfield Django or Wagtail project.
Jade Truffle is a work in progress. The intention is to make the base project quickly deployable, while at the same time allowing for project specific overrides.
Currently the template is highly tuned to an AWS/EKS deployment methodology using Django K8s, AWS Web Stacks, and K8s Web Cluster. The hope is that future work will add to the deployment methods.
Create a Python virtual environment with your tool of choice. For
purposes of these instructions we'll call the environment
jade-truffle
.
Enable your environment and install cookiecutter:
(jade-truffle)$ pip install cookiecutter
Now you have an environment that can install cookiecutter templates.
Next use cookiecutter to build a project using jade-truffle
:
(jade-truffle)$ cookiecutter https://github.com/caktus/jade-truffle
The cookiecutter will run through a series of configuration options
Project Name: This can be anything you like (e.g. Apple Pie)
Project Slug: Generated from the Project Name, but can be overridden. Used in most configuration options in the generated project.
apple_pie/apple_pie/settings
apple_pie/apple_pie/urls.py
Project Type: django
or wagtail
Testing Type: django
or pytest
CSS Style: sass
or tailwind
CI/CD: actions
or circleci
Cloud Provider: aws
or gcp
Postgres Port: Defaults to 5432
This is used for local dev so you can set this to any port you like.
NOTE: If you have a postgres server running locally on port 5432, you
will want to choose a different port than 5432.
Primary App: Will be used as the main app in the projects apps directory.
For example: `apple_pie/apps/apple_pie`
Project Domain Name:
Defaults to `caktus-built.com`
The generated project has a README that details the steps for install.