hacker-saran/production-fastapi-template

This project is a ready made starting point for building a backend web API using FastAPI, a popular Python framework for building web services. Instead of setting up a new project from scratch, a developer can copy this template and get a well organized, production style structure right away, along with automated checks that help keep the code clean and reliable. The template organizes code by feature, meaning each business capability lives in its own self contained folder rather than being spread across shared files. Inside each feature, a request flows through clear layers: a router that only handles incoming web requests and validates their shape, a service layer that contains the actual business rules, and a repository layer that talks to the database. A separate schemas file defines the exact shape of data coming in and going out, and a core package holds shared concerns like configuration, error handling, logging, and security. A notable part of this template is a docs folder specifically written to help AI coding assistants, such as Gemini, Cursor, or GitHub Copilot, understand the project's structure and conventions so they can generate code that fits in correctly on the first attempt. These documents describe the technology choices, the file layout rules, coding style standards, and how git branches and commits should be named. The template also sets up automated Git hooks, small scripts that run at certain points in the development workflow. Before a commit is created, the code is automatically linted and formatted with a tool called Ruff and type checked with MyPy. Before code is pushed to a shared repository, the full automated test suite runs with pytest, blocking the push if anything fails. Setup uses the uv package manager to install Python dependencies, and the project requires Python 3.12 or newer to run.