Backend based on FastAPI, using SQLModel to operate PostgreSQL, with Pydantic handling data validation and configuration
ViteReactPortfolio
full-stack-fastapi-template — Vite Portfolio Template
By FrankieGhaf
A public portfolio copy of fastapi/full-stack-fastapi-template, providing a FastAPI + React full-stack application skeleton with JWT login, an admin dashboard, and Docker Compose deployment configuration.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Author preview
Author-provided preview
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-02View source
What stands out
A quick read of the recorded project description.
Frontend uses React, TypeScript, Vite, Tailwind CSS, and shadcn/ui, served by FastAPI under the same domain
Built-in JWT authentication, password hashing, email password recovery, and React Email email templates
Provides a login page, admin dashboard, item management page, and dark mode interface
Test coverage with Pytest and Playwright, CI/CD based on GitHub Actions
Supports FastAPI Cloud or Docker Compose self-hosted deployment, the latter using Traefik for HTTPS
Template Details
This is a public portfolio copy of fastapi/full-stack-fastapi-template. The repository itself contains no additional customizations and is mainly used to demonstrate the structure and interface of this full-stack template. The template consists of a Python backend and a React frontend: the backend uses FastAPI to provide APIs, interacts with PostgreSQL through SQLModel, and uses Pydantic for data validation and configuration management; the frontend uses React, TypeScript, Vite, Tailwind CSS, and shadcn/ui, is served by FastAPI under the same domain, and includes an automatically generated frontend client.
Functionally, the template includes JWT authentication, default password hashing, email-based password recovery, React Email email templates, and Mailpit for local email testing during development. The interface includes a login page, an admin dashboard, and an item management page, and supports dark mode. For testing, it provides Pytest and Playwright, with CI/CD based on GitHub Actions.
There are two deployment paths: FastAPI Cloud, or self-hosting with Docker Compose, the latter using Traefik as a reverse proxy and automatically handling HTTPS. The repository README points to separate documentation for backend, frontend, development, deployment, and deployment-docker-compose.
Note that this entry covers the MIT-licensed version in the public repository. The license scope covers only that version of the code, not third-party assets such as demo images, fonts, or icons, and does not imply that external services such as domains, hosting, or databases are free.
ViteReactPortfolio
Is it right for your project?
Use Cases
- When you need a full-stack project starting point with login and an admin dashboard, you can create a new repository directly based on this template
- To see how FastAPI and React collaborate under the same domain and how the frontend client is automatically generated
- When you need to run supporting services such as PostgreSQL, Traefik, and Mailpit locally with Docker Compose
- To evaluate the structure of a backend application that uses JWT authentication and email password recovery as default options
Suitable For
- Developers familiar with Python and TypeScript who want to quickly build a full-stack backend prototype
- Internal tool projects that need an admin dashboard, user authentication, and a basic item management interface
- Teams that prefer Docker Compose self-hosting and want the reverse proxy and HTTPS already configured
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Click Use this template on GitHub to create a new repository, then modify the project name and configuration as needed
- 2
For the local development workflow, .env configuration, and Docker Compose service descriptions, see development.md
- 3
Backend and frontend development instructions are in backend/README.md and frontend/README.md respectively
- 4
For deployment, see deployment.md (FastAPI Cloud) or deployment-docker-compose.md (self-hosting)
- 5
Third-party assets such as demo images, fonts, and icons require separate license verification, and external services may charge additional fees
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free MIT-licensed version in the public repository; the free scope is that version of the code and does not mean external services or third-party assets are free.
Must comply with when using
- You may use, modify, commercialize, and distribute that version of the code for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may charge additional fees.
- One deployment path relies on the FastAPI Cloud external hosting service; using that service may involve account registration and fees, and is not provided free by the template code itself.
- Local email testing relies on Mailpit, an external service/tool that must be installed and run separately and is not a built-in capability of the template code.
- Self-hosted deployment requires you to prepare a Docker Compose environment and supporting services such as PostgreSQL and Traefik; the related infrastructure costs are borne by the user.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
☁️ [FastAPI Cloud](https://fastapicloud.com) for deployment.
Original README
📬 [Mailpit](https://mailpit.axllent.org) for local email testing during development.
Original README
https://github.com/FrankieGhaf/full-stack-fastapi-template/blob/master/LICENSEhttps://github.com/FrankieGhaf/full-stack-fastapi-template/blob/master/README.mdSelf-hosted deployment with Docker Compose: [deployment-docker-compose.md](./deployment-docker-compose.md).
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 85 / 100
- Technologies
- Vite · React
- Website type
- Portfolio
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-10-02
- Screenshot last checked
- 2026-10-04
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Vite as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 0efd6a53be63b7de181bff854f601a87e6be5b4ab39e69ad696505122455931d
2026-10-04T12:25:33.313Z
Source file / repository# Full Stack FastAPI Template [](../../actions/workflows/test-docker-compose.yml) [](../../actions/workflows/test-backend.yml) ## Technology Stack and Features - ⚡ [**FastAPI**](https://fastapi.tiangolo.com) for the Python backend API. - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) for the Python SQL database interactions (ORM). - 🔍 [Pydantic](https://docs.pydantic.dev), used by FastAPI, for the data validation and settings management. - 💾 [PostgreSQL](https://www.postgresql.org) as the SQL database. - 🚀 [React](https://react.dev) for the frontend. - 🧩 Built into the backend application and served by FastAPI on the same domain as the API. - 💃 Using TypeScript, hooks, [Vite](https://vitejs.dev), and other parts of a modern frontend stack. - 🎨 [Tailwind CSS](https://tailwindcss.com) and [shadcn/ui](https://ui.shadcn.com) for the frontend components. - 🤖 An automatically generated frontend client. - 🧪 [Playwright](https://playwright.dev) for end-to-end testing. - 🦇 Dark mode support. - ☁️ [FastAPI Cloud](https://fastapicloud.com) for deployment. - 🐋 [Docker Compose](https://www.docker.com) for local services and self-hosted deployment. - 📞 [Traefik](https://traefik.io) as a reverse proxy with automatic HTTPS. - 🔒 Secure password hashing by default. - 🔑 JWT (JSON Web Token) authentication. - 📫 Email-based password recovery. - ✉️ [React Email](https://react.email) for email templates. - 📬 [Mailpit](https://mailpit.axllent.org) for local email testing during development. - ✅ Tests with [Pytest](https://pytest.org). - 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions. ### Dashboard Login  ### Dashboard - Admin  ### Dashboard - Items  ### Dashboard - Dark Mode  ### React Email Templates  ### Mailpit - Local Email Testing  ### Interactive API Documentation  ## 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](./backend/README.md). ## Frontend Development Frontend docs: [frontend/README.md](./frontend/README.md). ## Deployment FastAPI Cloud deployment: [deployment.md](./deployment.md). Self-hosted deployment with Docker Compose: [deployment-docker-compose.md](./deployment-docker-compose.md). ## Development General development docs: [development.md](./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](./release-notes.md). ## License The Full Stack FastAPI Template is licensed under the terms of the MIT license.
Explore similar templates
Compare previews and descriptions within the same stack and category.
Resumify
Resumify is a browser-based resume builder built with React, TypeScript, and Vite.
Vite · Portfolio
showlit
Showlit is a personal website template built with React, Vite, TypeScript, Tailwind CSS, and shadcn/ui.
Vite · Portfolio
folium
A developer portfolio template built with Vite, React, TypeScript, and Tailwind CSS.
Vite · Portfolio
kurizu-discord
A personal portfolio website built with React and Vite that mimics the Discord desktop app, organizing projects, skills, and experience into customizable channels, threads, a member list, and emoji reactions.
Vite · Portfolio
about-me-personal-portfolio-website-template
AboutMe is a free personal website template built with Bootstrap and Vite, released under the MIT license. It provides a single-page index.html with organized src directories for images, JavaScript, and SCSS, along with npm scripts for development and build.
Vite · Portfolio
HackFolio
HackFolio is a hacker-style personal portfolio template for ethical hackers, penetration testers, bug bounty hunters, red teamers, and cybersecurity professionals.
Vite · Portfolio