Easy Django API Starter

A production-capable Django API foundation for maintainable business logic, admin workflows, and multi-client products.

Documentation · Discussions · Issues

“What do we build for, if not to lessen each other’s hardship?”

Important

This repository is currently in the foundation stage. Do not treat it as production-ready until the first stable release.

Best for

• REST APIs and business backends
• Backends shared by web, mobile, extensions, or bots
• Workflow-heavy and data-heavy products
• Products that benefit from Django Admin

Not for: A fleet of microservices or a prebuilt business domain that every product is forced to use.

Baseline

• Django + API foundations with clear app boundaries
• PostgreSQL, migrations, health checks, and structured configuration
• Admin, authentication foundations, and API documentation
• Testing, linting, typing, CI, and container-ready workflows
• AI-agent rules, specs, and architecture documentation

Quick start

Preferred:

fonij create my-product

Direct template use:

gh repo create my-product --template FonijBuild/easy-django-api-starter --private --clone
cd my-product
cp .env.example .env
uv sync
uv run python manage.py migrate
uv run python manage.py runserver

Project contract

• .fonij/starter.json describes this foundation to Fonij.
• AGENTS.md defines repository rules for AI coding agents.
• specs/ contains implementation-ready feature specifications.
• docs/ contains architecture and repository-specific guidance.
• Keep quality checks green before merging changes.

Contributing

Read CONTRIBUTING.md before contributing. Security issues must follow SECURITY.md.