full-stack-fastapi-template

Full Stack FastAPI Template es un proyecto inicial para construir aplicaciones web full-stack. Combina un backend en Python con FastAPI y un frontend en React, proporcionando toda la infraestructura necesaria para ejecutar y desplegar el resultado. Backend: FastAPI sirve la API, SQLModel gestiona las interacciones con la base de datos SQL como ORM, Pydantic proporciona validación de datos y gestión de configuraciones, y PostgreSQL es la base de datos SQL por defecto. La autenticación utiliza tokens JWT, las contraseñas se cifran de forma segura por defecto y se incluye recuperación de contraseña por correo electrónico. Frontend: React con TypeScript, hooks y Vite. El frontend se compila dentro de la aplicación backend y es servido por FastAPI en el mismo dominio que la API. Tailwind CSS y shadcn/ui proporcionan el estilo de los componentes, un cliente frontend generado automáticamente se comunica con la API, Playwright cubre las pruebas de extremo a extremo y se admite el modo oscuro. Correo electrónico: Se utiliza React Email para las plantillas de correo y Mailpit proporciona pruebas locales de correo durante el desarrollo. Despliegue y operaciones: FastAPI Cloud está documentado para el despliegue, y Docker Compose soporta servicios locales y despliegue autoalojado, con Traefik actuando como proxy inverso con HTTPS automático. Las pruebas utilizan Pytest y el CI/CD se basa en GitHub Actions. El README enlaza a documentación separada para backend, frontend, desarrollo general, despliegue en FastAPI Cloud, despliegue autoalojado con Docker Compose y notas de versión. El proyecto está pensado para usarse mediante el botón de plantilla del repositorio y tiene licencia MIT.