풀스택 FastAPI 템플릿

풀스택 FastAPI 템플릿 (Full Stack FastAPI Template)

새 프로젝트를 시작할 때마다 인증·DB·CI/CD를 처음부터 다 만드는 건 정말 피곤하죠. 그런 반복 작업을 덜어 주는 게 바로 Full Stack FastAPI 템플릿이에요. 초기 설정, 보안, 데이터베이스, 그리고 API 엔드포인트 몇 개까지 이미 다 만들어져 있어서, 시작점으로 아주 좋답니다. 🏁

출처: 공식문서

템플릿은 보통 특정 설정을 갖고 있긴 하지만, 유연하고 커스터마이즈할 수 있게 설계돼 있어요. 프로젝트 요구사항에 맞게 수정하고 적응시킬 수 있죠. 그래서 훌륭한 시작점이 됩니다. 🏁

이 템플릿으로 시작할 수 있어요. 초기 설정, 보안, 데이터베이스, 그리고 API 엔드포인트 일부가 이미 준비되어 있거든요.

GitHub Repository: Full Stack FastAPI Template

풀스택 FastAPI 템플릿 - 기술 스택과 기능

  • FastAPI로 만든 파이썬 백엔드 API.
    • 🧰 SQLModel로 파이썬 SQL 데이터베이스 연동(ORM).
    • 🔍 데이터 검증과 설정 관리를 위해 FastAPI가 쓰는 Pydantic.
    • 💾 SQL 데이터베이스로 PostgreSQL.
  • 🚀 프론트엔드로 React.
    • 💃 TypeScript, hooks, Vite, 그리고 현대 프론트엔드 스택의 다른 부분들 사용.
    • 🎨 프론트엔드 컴포넌트로 Tailwind CSSshadcn/ui.
    • 🤖 자동으로 생성되는 프론트엔드 클라이언트.
    • 🧪 End-to-End 테스트로 Playwright.
    • 🦇 다크 모드 지원.
  • 🐋 개발과 운영 모두 Docker Compose.
  • 🔒 기본적으로 보안 비밀번호 해싱.
  • 🔑 JWT(JSON Web Token) 인증.
  • 📫 이메일 기반 비밀번호 복구.
  • Pytest로 테스트.
  • 📞 리버스 프록시 / 로드 밸런서로 Traefik.
  • 🚢 Docker Compose 사용 배포 방법. 자동 HTTPS 인증서를 처리하는 프론트엔드 Traefik 프록시 설정 방법 포함.
  • 🏭 GitHub Actions 기반 CI(지속적 통합)와 CD(지속적 배포).

더 알아보기 (Learn more)