![NOTE] Please note that this project, fuzzy-couscous, will no longer receive further updates. Instead, check out its cooler and older brother, falco at: https://github.com/tobi-de/falco.
A cli tool based on django's startproject --template to bootstrap your django projects with a modern stack. The project template is heavily inspired by cookiecutter-django but is meant to be a simpler version. The cli also comes with additional commands to hopefully improve your django development experience.
- Django 4+
- Python 3.10+
- Frontend: htmx with editor support using web-types
- Template fragment with django-template-partials
- Secure production settings, https only.
- Settings using django-environ
- Login / signup via django-allauth
- Login using email instead of username
- Automatically reload your browser in development via django-browser-reload
- Better development experience with django-fastdev
- Amazon SES for production email via Anymail
- Docker ready for production
- Optional production cache settings using the
captain-definitionfor deploying to caprover
- Sentry for performance/error monitoring
- Serve static files with Whitenoise
- Default integration with pre-commit for identifying simple issues before submission to code review
- Integrated task runner with poethepoet
- Dependency management using poetry (can be replaced by virtualenv using the
I use github branches to create variations of the base template.
- main: The base template
- tailwind: The base template + tailwindcss via pytailwindcss
- bootstrap: The base template + bootstrap5 via django-bootstrap5
Note: If some of my decisions about the project template don't make sense to you, read this section of the documentation.
Install the latest version of the package
Initialize a new project
Poetry is required (not really, you can set up the environment however you want and install the requirements manually) to set up a virtualenv, install it then run the following:
Tests can then be run quickly in that environment:
If you have any feedback, please reach out to me at firstname.lastname@example.org or open a discussion.