FastAPI 백엔드와 React 프론트엔드를 한 번에 세팅하는 풀스택 프로젝트 템플릿
중간맛 분석
Python 백엔드 와 TypeScript 프론트엔드를 완전히 통합한 스타터 템플릿입니다. 사용자가 GitHub에서 템플릿으로 복사한 후 필요에 맞게 수정해서 프로젝트를 시작합니다. 백엔드는 FastAPI에 SQLModel ORM과 PostgreSQL 데이터베이스가 연결되어 있고, 프론트엔드는 Vite로 번들된 React 앱이 같은 도메인에서 FastAPI가 서빙합니다. 인증은 JWT 기반이고, 이메일 인증·비밀번호 복구는 React Email과 Mailpit(로컬 테스트)으로 구현되어 있습니다. 모든 서비스는 Compose로 한 번에 띄울 수 있으며, Traefik을 역프록시로 사용해 HTTPS도 자동 설정됩니다. 백엔드는 Pytest로, 화면은 Playwright로 테스트하고, GitHub Actions로 /를 구성합니다. 배포는 FastAPI Cloud 클라우드 서비스 또는 Compose로 직접 호스팅 가능합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 새 웹앱 프로젝트를 빠르게 시작하려는 팀이 미리 연결된 백엔드·프론트엔드와 로그인·권한 관리 구조를 복사해서 수정
- 로컬 개발부터 배포까지 Docker와 GitHub Actions로 자동화하고 싶은 개발자가 CI/CD와 서비스 구성 예시를 활용
- FastAPI와 React 통합 프로젝트의 구조를 배우고자 하는 개발자가 실제 작동하는 예제 코드를 참고
핵심 기능
대안 대비 차별점
백엔드와 프론트엔드가 하나의 저장소에서 관리되고 Docker Compose로 즉시 실행 가능하며, 프로덕션 배포(FastAPI Cloud 또는 self-hosted) 옵션까지 미리 구성되어 있습니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Docker 및 Docker Compose
- Python 3.11 이상 (로컬 백엔드 개발 시)
- Node.js 및 npm (로컬 프론트엔드 개발 시)
바로 차려먹기Node.js (bun)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/fastapi/full-stack-fastapi-template.git && cd full-stack-fastapi-template && bun install && bun run dev
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
-
GitHub에서 이 템플릿으로 새 저장소 만들기: 'Use this template' 버튼 클릭
-
저장소 클론하기:
git clone <당신의-저장소-URL>
cd full-stack-fastapi-template
- 환경 변수 설정하기:
cp .env.example .env
- Docker Compose로 모든 서비스 실행하기:
docker compose up
- 웹 브라우저에서 접속하기:
- 대시보드: http://localhost
- API 문서: http://localhost/api/v1/docs
- Mailpit(이메일 테스트): http://localhost:8025
- 개발 시 백엔드·프론트엔드 별도 실행 (선택사항):
backend 폴더에서:
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload
frontend 폴더에서:
cd frontend
npm install
npm run dev
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try fastapi/full-stack-fastapi-template
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2019년 생성
「백엔드·DB」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/fastapi/full-stack-fastapi-template)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기