fastapi-best-practices

What problem does it solve?

This Skill provides a standardized, domain-oriented structure and conventions for FastAPI projects, improving consistency, testability, and maintainability across teams.

Core Features & Use Cases

• Domain-driven project layout with clear separation of concerns (routers, schemas, models, services, dependencies).
• Guidelines for async vs sync routes, Pydantic models, global vs domain settings, and robust error handling.
• Use Case: start a new FastAPI service with a scalable structure and ready-to-extend modules for domains like auth, posts, and payments.

Quick Start

Initialize a new FastAPI project using the recommended domain-based structure, install dependencies, and run the app with uvicorn. Create a minimal example in src/{domain}/ with router.py, schemas.py, and models.py to see the pattern in action.