fastapi-production-template 0.1.4

Production-ready FastAPI template with CI/CD, Terraform, and complete tests

⚡ FastAPI Production Template

Battle-tested Python backend architecture — ready to ship.

By Kevin Meinon · Freelance Backend Engineer

→ Available for freelance projects ←

---

About

I'm Kevin Meinon, a freelance backend engineer specialising in Python and production-grade API systems — primarily FastAPI, but equally at home with Flask and Django depending on what the project calls for.

This template is a living showcase of the architecture patterns and engineering standards I bring to every engagement — not boilerplate to fill in, but a reference for what production-ready actually looks like.

What I build:

• High-throughput REST & async APIs with clean domain separation
• End-to-end CI pipelines with strict quality gates (lint, types, coverage)
• Cloud-portable infrastructure baselines (AWS / Azure / GCP)
• Systems that are easy for your team to own after I'm done

If your team needs a backend that ships fast and holds up — let's talk.

---

What this demonstrates

Concern	Approach
Architecture	App factory, versioned routes, repository pattern, domain layer separation — framework-agnostic patterns that port cleanly to Flask or Django
Data layer	SQLAlchemy async ORM + asyncpg + dependency-injected sessions
Auth	API key middleware (X-API-Key) with per-route enforcement
Observability	Structured JSON logging, request ID propagation, Prometheus-style metrics
Quality	100% coverage gate, Ruff linting, Ty type checking, pre-commit hooks
Infrastructure	Terraform modules for ECR (AWS), ACR (Azure), GAR (GCP)
Dev experience	Docker Compose with hot-reload dev profile, full local parity

---

Tech stack

• Runtime: Python 3.14
• Framework: FastAPI + Pydantic v2 · Flask · Django
• Database: PostgreSQL · SQLAlchemy async · asyncpg
• Tooling: uv · Ruff · Ty · pytest · tox
• Infrastructure: Docker · Docker Compose · Terraform (AWS / Azure / GCP)
• CI/CD: GitHub Actions

The FastAPI layer is intentionally thin and architecturally isolated — swapping it for Flask or Django is a configuration change, not a rewrite.

---

API surface

GET    /api/v1/health                       # public
GET    /api/v1/metrics                      # public
POST   /api/v1/documents/analyze            # requires X-API-Key
POST   /api/v1/documents                    # requires X-API-Key
GET    /api/v1/documents                    # requires X-API-Key
GET    /api/v1/documents/{document_id}      # requires X-API-Key
PUT    /api/v1/documents/{document_id}      # requires X-API-Key
DELETE /api/v1/documents/{document_id}      # requires X-API-Key

---

Local development

uv sync --all-groups
uv run uvicorn fastapi_production_template.main:app --reload

curl -H "X-API-Key: dev-api-key" http://localhost:8000/api/v1/documents

Quality gates

uv run pytest          # tests + coverage
uv run ruff check .    # linting
uv run ty check .      # type checking
uv run tox             # full gate

uv run pre-commit install
uv run pre-commit run --all-files

Docker

docker compose up --build

# Dev profile with hot reload
docker compose --profile dev up --build --watch api-dev postgres

Terraform

terraform -chdir=infra/terraform-aws   init && validate
terraform -chdir=infra/terraform-azure init && validate
terraform -chdir=infra/terraform-gcp   init && validate

---

Hire me

I'm available for backend contracts and freelance projects.

Backend feature delivery · API performance & reliability · CI quality gates · Cloud deployment

[e-mail]