fastapi-conventions

Structure FastAPI projects by enforcing modular design with per-feature modules, APIRouters, and reusable dependencies. This approach reduces endpoint repetition and improves navigation, making the API easier to maintain and scale.

Manage FastAPI lifespan and configuration by using a create_app() factory pattern with async lifespan for startup/shutdown coordination. Centralize environment-driven app settings via pydantic-settings to tailor OpenAPI output.

Use Pydantic v2 schemas for FastAPI validation by leveraging model_config and validators. This ensures robust data models and smooth ORM integration for your application's request and response payloads.

Yes, you can compose reusable dependencies like get_current_user and get_db across feature routers. This FastAPI dependency injection approach centralizes security and database session logic for production-ready APIs.

Yes, this modular FastAPI architecture is applicable to building robust, production-ready APIs across small to large projects. It enforces router-level dependencies, factory-based app creation, and OpenAPI customization for scalability.

Group related FastAPI endpoints under a shared prefix and tags by using an APIRouter per feature module. This modular pattern reduces repetition and significantly improves API navigation.