fands.dev django template

What is in the box

• API-only django (checkout this post in Russian) based on Django REST Framework with JWT support.
• poetry with separate development-time dependencies.
• Strict type checking with mypy, django-stubs and djangorestframework-stubs.
• tons of linters and formatters (contact us if any interesting linter is not included, see Makefile fmt, lint commands).
• Starter CI configuration on GitHub Actions.
• pytest with useful stuff like freezegun, pytest-mock and super convinient [DRF test client](https://github.com/fandsdev/django/blob/master/{{ cookiecutter.name }}/src/app/testing/api.py).
• Custom user model.
• drf-spectacular for API Schema generation.
• django-axes for additional security.
• Whitenoise for effortless static files hosting.
• Cloudflare ready with django-ipware.
• Sentry. Set SENTRY_DSN env var if you need it.
• Postgres.

Installation

You need python 3.11, poetry<2 and cookiecutter. The poetry sticks to poetry v1.x as the project plans to migrate to uv package manager.

We only support PostgreSQL as the database backend, so make sure it runs on localhost:5432 before installing the project.

pipx install 'poetry<2'
pipx install cookiecutter

cookiecutter gh:fandsdev/django

FAQ

I wanna hack this!

Thank you so much! Check out our build pipeline and pick any free issue.