FastAPI Templates

This skill provides production-ready templates and scaffolding patterns for FastAPI applications.

When to Use

• Starting a new FastAPI service or project.

• Adding standard components (Auth, DB, Logging) to an existing app.

• Standardizing project structure across the team.

Project Structure Template

Recommended structure for scalable FastAPI apps:

src/ ├── api/ │ ├── v1/ │ │ ├── endpoints/ # Route handlers │ │ └── api.py # Router aggregation │ └── deps.py # Dependencies (get_current_user, etc.) ├── core/ │ ├── config.py # Pydantic BaseSettings │ └── security.py # JWT & Password hashing ├── db/ │ ├── models/ # SQLAlchemy models │ ├── session.py # DB engine and session factory │ └── base.py # Import all models here ├── schemas/ # Pydantic models (Request/Response) ├── services/ # Business logic └── main.py # App entrypoint

Code Templates

1. Standard API Endpoint

from fastapi import APIRouter, Depends, HTTPException from sqlalchemy.ext.asyncio import AsyncSession from src.api import deps from src.schemas.item import ItemCreate, Item from src.services import item_service

router = APIRouter()

@router.post("/", response_model=Item) async def create_item( item_in: ItemCreate, db: AsyncSession = Depends(deps.get_db), current_user = Depends(deps.get_current_user), ) -> Item: """ Create a new item. """ return await item_service.create(db, obj_in=item_in, owner_id=current_user.id)

2. Pydantic Settings

from pydantic_settings import BaseSettings

class Settings(BaseSettings): PROJECT_NAME: str = "FastAPI App" DATABASE_URL: str SECRET_KEY: str

class Config:
    case_sensitive = True
    env_file = ".env"

settings = Settings()

3. SQLAlchemy Async Model

from sqlalchemy import Column, Integer, String from src.db.base_class import Base

class Item(Base): id = Column(Integer, primary_key=True, index=True) title = Column(String, index=True) description = Column(String, nullable=True)