2.0 KiB

Raw Blame History

Minimal FastAPI Template

A minimal production-ready FastAPI template with JWT authentication and PostgreSQL.

Features

FastAPI with async/await
JWT access token authentication
PostgreSQL with SQLAlchemy 2.0 (async)
Alembic migrations
Domain-driven structure
Docker and docker-compose setup

Quick Start

Copy .env.example to .env and update the values:

cp .env.example .env

Start the services:

docker-compose up -d

The API will be available at http://localhost:8000

API docs at http://localhost:8000/docs

Project Structure

backend/
├── app/
│   ├── auth/              # Authentication domain
│   ├── core/              # Core utilities and shared code
│   ├── user/              # User domain
│   ├── config.py          # Application settings
│   ├── factory.py         # FastAPI app factory
│   └── __main__.py        # Entry point
├── alembic/               # Database migrations
├── pyproject.toml         # Dependencies
├── Dockerfile
└── .env.example

Development

Install dependencies:

cd backend
pip install -e ".[dev]"

Run locally:

cd backend/app
python -m uvicorn __main__:app --reload

Create new migration:

cd backend
alembic revision --autogenerate -m "description"

Run migrations:

cd backend
alembic upgrade head

API Endpoints

POST /v1/users - Register new user
POST /v1/auth/login - Login (returns access token)
GET /v1/auth/me - Get current user
POST /v1/auth/logout - Logout (placeholder)
POST /v1/users/change-password - Change password
GET /health - Health check
GET /health/detailed - Detailed health check

Extending

This is a minimal starting point. You can add:

Refresh tokens
Email verification
Password reset
User roles
Rate limiting (add Redis + slowapi)
Structured logging (add structlog)
More domains following the same pattern

2.0 KiB Raw Blame History