Fastapi Structure

FastAPI Project Structure

This skill defines how to organize a FastAPI backend using a modular structure.

Project Structure

project_root/ ├── main.py ├── configuration/ │ └── settings.py ├── backend/ │ ├── init.py │ ├── auth.py │ ├── models.py │ ├── controllers/ │ │ ├── init.py │ │ ├── health_controller.py │ │ ├── <domain>_controller.py │ ├── responses/ │ └── utils/ ├── tests/ │ └── test_endpoints.py └── requirements.txt

Responsibilities

main.py

• App creation
• Middleware configuration
• Router inclusion
• Lifespan events
• MUST NOT contain endpoint logic

---

configuration/settings.py

• Environment variables
• Constants
• App configuration

---

backend/controllers/