Repolode
fastapi

fastapi/full-stack-fastapi-template

Template de aplicação web full-stack que combina backend FastAPI, frontend React, banco de dados PostgreSQL e configuração com Docker Compose.

Estrelas
46,051
Forks
9,153
Issues abertas
12
Último commit
há 6 dias

O que é?

Este template oferece um ponto de partida para uma aplicação web full-stack. O backend é feito com FastAPI, usa SQLModel para acessar o banco de dados PostgreSQL e conta com Pydantic para validação. O frontend é uma aplicação React feita com TypeScript e Vite, estilizada com Tailwind CSS e componentes shadcn/ui, e servida pelo FastAPI no mesmo domínio da API.

Por padrão, o template inclui autenticação JWT, hash seguro de senhas, recuperação de senha por e-mail com templates do React Email e uma configuração do Mailpit para testar e-mails localmente. O Docker Compose executa os serviços locais, e o Traefik fornece um proxy reverso com HTTPS automático para implantação própria. O Pytest cobre os testes do backend, o Playwright cobre os testes end-to-end, e o GitHub Actions cuida de CI e CD.

Para começar, crie um novo repositório a partir do template. Há guias de implantação para o FastAPI Cloud e para hospedagem própria com Docker Compose.

Recursos principais

  • 01Backend FastAPI com ORM SQLModel no PostgreSQL
  • 02Frontend React e TypeScript feito com Vite, Tailwind CSS e shadcn/ui
  • 03Autenticação JWT e hash seguro de senhas
  • 04Recuperação de senha por e-mail com templates do React Email
  • 05Configuração com Docker Compose e Traefik para HTTPS automático
  • 06Testes do backend com Pytest, testes end-to-end com Playwright e CI/CD com GitHub Actions

Casos de uso

  • Começar uma nova aplicação web que precise de uma API em Python e de um painel React
  • Criar um painel administrativo com login de usuários e páginas CRUD
  • Hospedar por conta própria uma aplicação web com Docker Compose e HTTPS
  • Implantar um projeto FastAPI no FastAPI Cloud

Início rápido

  1. 1

    Crie um novo repositório a partir deste modelo usando o botão «Usar este modelo»

  2. 2

    Consulte o guia de desenvolvimento para conhecer o fluxo de trabalho local e a configuração do Docker Compose

Antes de usar

  • A configuração local padrão requer Docker e Docker Compose, conforme descrito na documentação de desenvolvimento.

Tópicos

Perguntas frequentes

O que é full-stack-fastapi-template?
Template de aplicação web full-stack que combina backend FastAPI, frontend React, banco de dados PostgreSQL e configuração com Docker Compose. Este template oferece um ponto de partida para uma aplicação web full-stack. O backend é feito com FastAPI, usa SQLModel para acessar o banco de dados PostgreSQL e conta com Pydantic para validação. O frontend é uma aplicação React feita com TypeScript e Vite, estilizada com Tailwind CSS e componentes shadcn/ui, e servida pelo FastAPI no mesmo domínio da API.
full-stack-fastapi-template é gratuito? Qual é a licença?
full-stack-fastapi-template é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
full-stack-fastapi-template ainda é mantido?
Manutenção ativa. O último commit de full-stack-fastapi-template foi em 15 de out. de 2026.
Para que posso usar full-stack-fastapi-template?
Começar uma nova aplicação web que precise de uma API em Python e de um painel React Criar um painel administrativo com login de usuários e páginas CRUD Hospedar por conta própria uma aplicação web com Docker Compose e HTTPS Implantar um projeto FastAPI no FastAPI Cloud
Como instalar full-stack-fastapi-template?
Crie um novo repositório a partir deste modelo usando o botão «Usar este modelo» Consulte o guia de desenvolvimento para conhecer o fluxo de trabalho local e a configuração do Docker Compose
Onde consigo full-stack-fastapi-template?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fastapi/full-stack-fastapi-template

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados