Easy Starter Django Backend

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

Provides a consistent backend foundation so projects start with secure settings, clear app boundaries, repeatable local development, and production checks.

• REST APIs and business backends
• Django Admin-based operations
• Backends for Next.js, mobile apps, bots, and extensions
• Data-heavy and workflow-driven products

Not intended for: A microservice fleet or a prebuilt domain model for every business.

• Environment-specific settings and validation
• Custom user model and admin foundations
• PostgreSQL, migrations, health checks, and structured logging
• Docker-based local and production workflows
• Tests, linting, type checks, CI, and deployment checklist

Detailed architecture, conventions, deployment profiles, and extension guides belong in docs/. Feature work starts from specs/, and agent rules live in AGENTS.md.

1. Click Use this template, create new repo in your own account, and clone it on your system.

2. Set the project name, package metadata, and environment values.

3. Start the project:

   cp .env.example .env
   make setup
   make dev
   make check

4. Write the first feature specification under specs/.

5. Implement the feature and keep make check green.

• Read AGENTS.md and the relevant specification before changing code.
• Reuse existing patterns before adding abstractions or dependencies.
• Never commit credentials or production data.
• Run the repository quality checks before opening a pull request.
• Record architecture-changing decisions in docs/decisions/.

Start with docs/getting-started.md. Broader AI-first development guidance is maintained in Easy Starter Docs.

See CONTRIBUTING.md for contribution rules and SUPPORT.md for help. Security issues must follow SECURITY.md.

Released under the MIT License.