full-stack-fastapi-template

Full Stack FastAPI Template is a starter project for building full-stack web applications. It pairs a Python FastAPI backend with a React frontend and provides the surrounding infrastructure needed to run and deploy the result. Backend: FastAPI serves the API, SQLModel handles SQL database interactions as an ORM, Pydantic provides data validation and settings management, and PostgreSQL is the default SQL database. Authentication uses JWT tokens, passwords are hashed securely by default, and email-based password recovery is included. Frontend: React with TypeScript, hooks and Vite. The frontend is built into the backend application and served by FastAPI on the same domain as the API. Tailwind CSS and shadcn/ui supply the component styling, an automatically generated frontend client talks to the API, Playwright covers end-to-end testing, and dark mode is supported. Email: React Email is used for email templates, and Mailpit provides local email testing during development. Deployment and operations: FastAPI Cloud is documented for deployment, and Docker Compose supports local services and self-hosted deployment, with Traefik acting as a reverse proxy with automatic HTTPS. Tests use Pytest, and CI/CD is based on GitHub Actions. The README links to separate documentation for backend, frontend, general development, FastAPI Cloud deployment, self-hosted Docker Compose deployment, and release notes. The project is intended to be used via the repository template button and is licensed under MIT.