wemake-django-template

Bleeding edge django5.2 template focused on code quality and security. Documentation.

---

Purpose

This project is used to scaffold a django project structure. Just like django-admin.py startproject but better.

Features

• Always up-to-date with the help of @dependabot
• Supports latest python3.12
• poetry@2 for managing dependencies
• mypy and django-stubs for static typing
• pytest and hypothesis for unit tests
• ruff and wemake-python-styleguide for linting
• docker for development, testing, and production
• sphinx for documentation
• Gitlab CI with full build, test, and deploy pipeline configured by default
• Caddy with https and http/2 turned on by default
• Monorepo structure out-of-the-box: includes a React + Vite + TypeScript frontend with Zustand state management, integrated seamlessly with the Django backend via Docker Compose.

Installation

Firstly, you will need to install dependencies.

The recommended way is via uvx:

uvx --with jinja2-git cookiecutter gh:wemake-services/wemake-django-template

---

Or via pipx:

pipx install cookiecutter
pipx inject cookiecutter jinja2-git

Or via global pip:

pip install cookiecutter jinja2-git

Then, create a project itself:

cookiecutter gh:wemake-services/wemake-django-template

Development Setup (Assisted by AI)

This template includes a pre-configured monorepo setup featuring a Django backend and a React (Vite + TypeScript) frontend, fully containerized for local development.

To start the development environment:

cd <your-generated-project-name>
docker compose up --build

This command will spin up:

• Django Backend: Available on http://localhost:8000
• React Frontend: Available with Hot Module Replacement (HMR) on http://localhost:5173
• PostgreSQL Database: Running isolated in the background

Auto-Generate with AI (Single Prompt)

This template is designed for automatic execution by AI Assistants (such as Cursor, Claude, or other AI Agents). Simply copy-paste the following single-paragraph prompt to your AI, and let it autonomously handle the cloning, setup, and feature creation process:

"Please clone and generate a new project using the template cookiecutter git@github.com:juandisay/wemake-django-template.git (fill the interactive prompts with defaults). Once generated, start the local environment using docker compose up --build. After the services are running, please create a full-stack 'Todo List' feature: build the model and API endpoint on the backend (Django), then build a TypeScript UI component with state management (Zustand) on the frontend (React) to fetch and manipulate the data, ensuring smooth integration between both sides."

Who is using this template?

If you use our template, please add yourself or your company in the list.

Here's a nice list of real-life open-source usages of this template.

License

MIT. See LICENSE for more details.