Repolode
Submit
fastapi

fastapi/full-stack-fastapi-template

A full-stack web app template combining a FastAPI backend, React frontend, PostgreSQL database and Docker Compose setup.

View on GitHub
Stars
46,051
Forks
9,153
Open issues
12
Last commit
6 days ago

What is it?

This template gives you a starting point for a full-stack web application. The backend is built with FastAPI, uses SQLModel for database access against PostgreSQL, and relies on Pydantic for validation. The frontend is a React app built with TypeScript and Vite, styled with Tailwind CSS and shadcn/ui components, and served by FastAPI on the same domain as the API.

Out of the box it includes JWT authentication, secure password hashing, email-based password recovery with React Email templates, and a Mailpit setup for testing email locally. Docker Compose runs the local services, and Traefik provides a reverse proxy with automatic HTTPS for self-hosted deployment. Pytest covers the backend, Playwright covers end-to-end tests, and GitHub Actions handles CI and CD.

You start by creating a new repository from the template. Deployment guides exist for FastAPI Cloud and for self-hosting with Docker Compose.

Key features

  • 01FastAPI backend with SQLModel ORM on PostgreSQL
  • 02React and TypeScript frontend built with Vite, Tailwind CSS and shadcn/ui
  • 03JWT authentication and secure password hashing
  • 04Email-based password recovery with React Email templates
  • 05Docker Compose setup with Traefik for automatic HTTPS
  • 06Pytest backend tests, Playwright end-to-end tests and GitHub Actions CI/CD

Use cases

  • Starting a new web app that needs a Python API and a React dashboard
  • Building an admin panel with user login and CRUD pages
  • Self-hosting a web application with Docker Compose and HTTPS
  • Deploying a FastAPI project to FastAPI Cloud

Quick start

  1. 1

    Create a new repository from this template using the Use this template button

  2. 2

    Read the development guide for the local workflow and Docker Compose setup

Things to know

  • Requires Docker and Docker Compose for the standard local setup, as described in the development docs.

Topics

#fastapi#react#postgresql#docker-compose#full-stack#typescript#sqlmodel#jwt#docker#fastapi-cloud

FAQ

What is full-stack-fastapi-template?
A full-stack web app template combining a FastAPI backend, React frontend, PostgreSQL database and Docker Compose setup. This template gives you a starting point for a full-stack web application. The backend is built with FastAPI, uses SQLModel for database access against PostgreSQL, and relies on Pydantic for validation. The frontend is a React app built with TypeScript and Vite, styled with Tailwind CSS and shadcn/ui components, and served by FastAPI on the same domain as the API.
Is full-stack-fastapi-template free to use? What license does it have?
full-stack-fastapi-template is open source under the MIT license. Check the license terms before using it in commercial products.
Is full-stack-fastapi-template still maintained?
Actively maintained. The last commit to full-stack-fastapi-template was on Oct 15, 2026.
What can I use full-stack-fastapi-template for?
Starting a new web app that needs a Python API and a React dashboard Building an admin panel with user login and CRUD pages Self-hosting a web application with Docker Compose and HTTPS Deploying a FastAPI project to FastAPI Cloud
How do I install full-stack-fastapi-template?
Create a new repository from this template using the Use this template button Read the development guide for the local workflow and Docker Compose setup
Where can I get full-stack-fastapi-template?
The source code and installation instructions are on GitHub: https://github.com/fastapi/full-stack-fastapi-template

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects