Skip to content

Our production ready (too much) opinionated django template

License

Notifications You must be signed in to change notification settings

fandsdev/django

Repository files navigation

fands.dev django template

Shields.io

Easy peasy

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 and cookiecutter.

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

pipx install poetry
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.