full-stack-fastapi-template

fastapiMIT活跃维护

用 FastAPI + React + PostgreSQL 搭好的全栈项目脚手架,自带 JWT 登录、Docker Compose 和 CI 配置,省去从零搭建后端接口、前端页面和部署流程的麻烦。

Full-stack web application template with FastAPI, React, SQLModel, PostgreSQL, Vite, Tailwind CSS, shadcn/ui, FastAPI Cloud, and Docker Compose.

0.12.0发布于 2026-08-12 08:51 UTC46,217star +34 / 7 天9,218fork同步于 2026-11-10 05:19 UTC

怎么上手

README 里没有找到可直接复制的安装命令

README 里没有找到可直接复制的安装命令,请到 README 或官方文档查看安装方式。

硬件要求按 README 关键词推断
有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

这个项目的说明还在生成中,先参考下面「最近发版」和 README。

最近发版

5 个版本0.12.0
  1. 0.12.0最新正式版2026-08-12 · 2026-08-12 08:51 UTC

    Features

    Fixes

    • 🐳 Include frontend assets in Docker build context. PR #2440 by @tiangolo.

    Internal

    • 👷 Migrate automatic labels to Latest Changes. PR #2439 by @tiangolo.
  2. 0.11.12026-08-11 · 2026-08-11 20:10 UTC
    查看更新说明

    Refactors

    • ♻️ Simplify Docker Compose deployment. PR #2435 by @tiangolo.
    • ♻️ Migrate to DATABASE_URL instead of separate variables. PR #2184 by @patrick91.

    Internal

  3. 0.11.02026-08-11 · 2026-08-11 09:36 UTC
    查看更新说明

    Features

    Fixes

    Refactors

    Upgrades

  4. 0.10.02026-01-23 · 2026-01-23 16:47 UTC
    查看更新说明

    Features

    • ✅ Add items and admin tests, and refactor existing ones. PR #2146 by @alejsdev.
    • ✨ Add created_at field to User and Item models and update endpoints. PR #2144 by @alejsdev.
    • 🔧 Migrate from npm to Bun. PR #2097 by @alejsdev.
    • 🔧 Set up node monorepo. PR #2095 by @alejsdev.
    • 🧑‍💻 Implement uv workspaces. PR #2090 by @alejsdev.
    • 🔧 Add recommended VS Code extensions. PR #1386 by @tobiase.
    • ✨ Use pwdlib with Argon2 by default, adding logic (and tests) to autoupdate old passwords using Bcrypt. PR #2104 by @tiangolo.
    • 🔨 Generate frontend SDK on pre-commit, remove custom workflow. PR #2111 by @tiangolo.

    Fixes

    • 🐛 Add user authentication check in admin route to restrict access for non-superusers. PR #2145 by @alejsdev.
    • 🐛 Handle non-existing user IDs in read_user_by_id. PR #1396 by @saltie2193.

    Refactors

    • 🔥 Remove debugpy from recommended extensions, it's included by the Python extension. PR #2143 by @tiangolo.
    • 🔧 Update the frontend build context for prod with the new top level setup. PR #2108 by @tiangolo.
    • 🚚 Rename Docker Compose files to new names, compose.yml. PR #2106 by @tiangolo.
    • 🔒️ Ensure authentication takes constant time, to avoid enumeration attacks. PR #2105 by @tiangolo.
    • ✅ Fix incorrect mocking in unit tests (issue #1780). PR #1781 by @vicaya.
    • 🐛Update items.py to return status code 403 in case of insufficient permissions. PR #1543 by @jpizquierdo.
    • ✅ Use proper is_active field in test_user.py. PR #1479 by @nauanbek.
    • ♻️ Simplify reset password logic by removing duplicate code. PR #1440 by @youneshenniwrites.

    Upgrades

    Docs

    Internal

    • 🎨 Format Python scripts te
  5. 0.9.02025-12-08 · 2025-12-08 19:14 UTC
    查看更新说明

    Features

    Fixes

    • 🐛 Fix EMAILS_FROM_NAME type to be str instead of EmailStr. PR #1940 by @martin0258.
    • 🐛 Fix parse_cors function to be consistent for both empty string and empty list. PR #1672 by @rolkotaki.
    • 🐛 Close sidebar drawer on user selection. PR #1515 by @dtellz.
    • 🐛 Fix required password validation when editing user fields. PR #1508 by @jpizquierdo.

    Refactors

    • ♻️ Update password max length. PR #1447 by @michaelAlvarino.
    • 🚚 Move backend tests outside the app directory. PR #1862 by @YuriiMotov.
    • ✨ Add ImportMetaEnv and ImportMeta interfaces for Vite environment variables. PR #1860 by @alejsdev.
    • 🔧 Update tsconfig.json and fix errors. PR #1859 by @alejsdev.
    • ♻️ Remove disabled attribute from Save button in ChangePassword component. PR #1844 by @alejsdev.
    • 👷🏻‍♀️ Update CI for client generation. PR #1573 by @alejsdev.
    • ♻️ Remove redundant field in inherited class. PR #1520 by @tzway.
    • 🎨 Add minor UI tweaks in Skeletons and other components. PR #1507 by @alejsdev.
    • 🎨 Add minor UI tweaks. PR #1506 by @alejsdev.

    Upgrades

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Full Stack FastAPI Template

    Test Docker Compose Test Backend

    Technology Stack and Features

    • ⚡ FastAPI for the Python backend API.
      • 🧰 SQLModel for the Python SQL database interactions (ORM).
      • 🔍 Pydantic, used by FastAPI, for the data validation and settings management.
      • 💾 PostgreSQL as the SQL database.
    • 🚀 React for the frontend.
      • 🧩 Built into the backend application and served by FastAPI on the same domain as the API.
      • 💃 Using TypeScript, hooks, Vite, and other parts of a modern frontend stack.
      • 🎨 Tailwind CSS and shadcn/ui for the frontend components.
      • 🤖 An automatically generated frontend client.
      • 🧪 Playwright for end-to-end testing.
      • 🦇 Dark mode support.
    • ☁️ FastAPI Cloud for deployment.
    • 🐋 Docker Compose for local services and self-hosted deployment.
      • 📞 Traefik as a reverse proxy with automatic HTTPS.
    • 🔒 Secure password hashing by default.
    • 🔑 JWT (JSON Web Token) authentication.
    • 📫 Email-based password recovery.
    • ✉️ React Email for email templates.
    • 📬 Mailpit for local email testing during development.
    • ✅ Tests with Pytest.
    • 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.

    Dashboard Login

    Dashboard login screenshot

    Dashboard - Admin

    Admin dashboard screenshot

    Dashboard - Items

    Items dashboard screenshot

    Dashboard - Dark Mode

    Dark mode dashboard screenshot

    React Email Templates

    Email templates screenshot

    Mailpit - Local Email Testing

    Mailpit screenshot

    Interactive API Documentation

    API docs

    How to Use It

    Click the Use this template button at the top of this page to create a new repository.

    Backend Development

    Backend docs: backend/README.md.

    Frontend Development

    Frontend docs: frontend/README.md.

    Deployment

    FastAPI Cloud deployment: deployment.md.

    Self-hosted deployment with Docker Compose: deployment-docker-compose.md.

    Development

    General development docs: development.md.

    This includes the local FastAPI and Vite workflow, Docker Compose services, .env configuration, and more.

    Release Notes

    Check the file release-notes.md.

    License

    The Full Stack FastAPI Template is licensed under the terms of the MIT license.