Peopl3s/clean-architecture-litestar-project-template

This system is a Python-based application template built on a clean architecture, utilizing Litestar, SQLAlchemy, and Redis/PostgreSQL. It provides a complete development environment with Docker, CI/CD, and automated setup scripts to simplify project initialization. The codebase is structured with unit of work and database mapping modules, supported by tooling for linting, formatting, and testing.

A new Python script, hooks/post\_gen\_project.py, has been added to the project. This post-generation hook automatically creates a .env file based on the cookiecutter template context, configuring database, cache, and message broker URLs, along with security and application settings. This simplifies the initial setup process for new projects generated from the template.

hooks · high confidence

The project is initialized with a complete development environment, including a multi-stage Dockerfile, docker-compose configurations for production, development, and testing, and a Makefile with commands for linting, formatting, type-checking, and testing. A .gitignore and .dockerignore are added to exclude build artifacts and environment files. The README documents the clean architecture structure, technology stack (Litestar, SQLAlchemy, Redis/PostgreSQL), and how to run the application. Documentation for Docker, environment setup, database migrations, and tooling (Ruff, MyPy) is also included. New Python modules for unit of work and database mapping are created.

_{{cookiecutter.project\slug}} · high confidence

The project's dependency manifest (pyproject.toml) has been updated with newer versions of key libraries, including pydantic 2.12.4, alembic 1.17.2, uvicorn 0.38.0, faststream 0.6.3, and sqlalchemy 2.0.44, among others. Additionally, a new docs/requirements.txt file was added to pin documentation build tools such as Sphinx 8.2.3 and related extensions.

(dependencies) · medium confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 58 → 46 (-11.5)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 99 (new)
• Architecture 100 → 81 (-18.9)
• Maturity 55 → 55 (+0.0)
• Readiness 39 → 42 (+2.5)
• Security 100 → 96 (-4.1)
• Accessibility 33 (new)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• LLM evaluation failed
• No exposed public API
• Test reliability not included
• complexity unreadable for .py — churn × complexity hotspots could not be measured
• dormant codebase — no living knowledge left to concentrate

• Documentation: no installation or build instructions (docs/_build/html/user-guide/project-structure.html)
• High IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• High IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• High IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• High IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Low IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.override.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-COMPOSE-0002 ({{cookiecutter.project_slug}}/docker-compose.yml)
• Medium IaC: WD-DOCKER-0003 ({{cookiecutter.project_slug}}/Dockerfile)
• Medium IaC: WD-DOCKER-0004 ({{cookiecutter.project_slug}}/Dockerfile)
• Outdated: alembic
• Outdated: dishka
• Outdated: faststream
• …and 5 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Peopl3s/clean-architecture-litestar-project-template was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.