Google 로그인 대신 카카오·네이버가 필요하고, Stripe 대신 토스페이먼츠로 정기결제를 다시 짜야 하고, 이메일 대신 알림톡을 붙여야 합니다. 각각이 문서 찾아가며 며칠씩 걸리는 작업이고, 프로젝트를 새로 시작할 때마다 반복됩니다. BaroKit에는 이 작업들이 이미 동작하는 상태로 들어 있습니다.
| 글로벌 보일러플레이트 | BaroKit | |
|---|---|---|
| 결제 | Stripe · Lemon Squeezy | 토스페이먼츠 빌링키 정기결제 |
| 로그인 | 구글 · GitHub | 카카오 · 네이버 (+구글) |
| 알림 | 이메일만 | 알림톡 + 이메일 자동 폴백 |
| 약관 | 영문 템플릿 | 전자상거래법·개인정보보호법 기준 한국어 |
| 문서 | 영어 | 전부 한국어 |
문서에 안 나오는 함정들까지 미리 밟아두었습니다.
카드 등록 → 매월 자동 승인 → 실패 시 1·3·5일 재시도 → 정지 → 카드 변경 복구 → 해지 예약까지. 전이 전수 테스트 포함.
토스 자동결제는 승인 웹훅이 없습니다. 타임아웃을 실패로 단정하고 재시도하면 이중결제 — 조회 API 재확인·멱등 주문번호로 3중 방어합니다.
카카오·네이버는 이메일이 선택 동의라 null일 수 있습니다. placeholder 전략과 이메일 보완 온보딩이 이미 구현되어 있습니다.
템플릿 심사제·발신프로필 같은 알림톡 특유의 제약을 템플릿 레지스트리로 정리. 심사 전엔 이메일로 자동 폴백됩니다.
조직 단위 데이터 격리가 스키마부터 설계되어 있고, 개인 서비스용 "1인 = 1조직 자동 생성" 모드가 기본입니다.
CLAUDE.md와 도메인 규칙 파일이 동봉되어, Claude Code가 이 코드베이스의 컨벤션대로 기능을 확장해줍니다.
각 서비스의 키 발급 방법은 문서에 화면 단위로 정리되어 있습니다.
구매 즉시 전체 소스 코드를 zip으로 내려받습니다. 압축 풀고 pnpm install 하면 준비 끝.
.env에 카카오/네이버/토스/알림톡 키를 넣습니다. 키가 없어도 로컬 개발과 토스 테스트 결제는 바로 동작합니다.
Vercel에 연결하면 끝. Docker 셀프호스팅 구성도 포함되어 있습니다.
라이브 데모 — 이 데모 자체가 BaroKit으로 만들어졌습니다. 테스트 카드로 구독 결제 플로우까지 확인할 수 있습니다.
직접 구현하면 보통 2~4주 걸리는 작업입니다 — 시간으로 환산해보세요.
결제는 Lemon Squeezy(달러)로 처리되며 영수증이 발급됩니다.
AI는 그럴듯한 결제 코드를 즉석에서 만들지만, "토스 자동결제는 승인 웹훅이 없다", "타임아웃을 실패로 단정하면 이중결제가 난다" 같은 함정은 실제로 연동해봐야 압니다. 이 스타터는 그 함정들을 이미 밟고 테스트로 봉인해둔 코드입니다. 게다가 도메인 규칙 파일이 동봉되어 있어 AI 코딩 도구가 이 위에서 더 정확하게 동작합니다 — 경쟁이 아니라 궁합입니다.
Next.js 16(App Router) + TypeScript strict + Tailwind v4 + shadcn/ui + Drizzle ORM + PostgreSQL + better-auth. 시장에서 가장 검증된 조합입니다. Next.js 풀스택(Route Handlers) 구조라 별도 백엔드 서버 없이 Vercel 배포만으로 운영 가능하고, Docker 셀프호스팅 구성도 포함되어 있습니다.
구매 후 1년간 업데이트가 제공됩니다. 버그 수정과 토스·카카오 API 변경 대응이 포함되며, Next.js 메이저 업데이트는 검증 후 순차 대응합니다. 새 버전이 나오면 이메일로 안내되고, 구매하신 다운로드 링크에서 다시 받으면 됩니다.
네. 개발자센터 가입만 하면 즉시 발급되는 테스트 키로 카드 등록부터 정기결제까지 전 플로우를 개발·검증할 수 있습니다. 실제 판매 시점에 전자결제 계약(+자동결제 추가 계약)을 진행하면 됩니다. 절차는 문서에 정리되어 있습니다.
가맹점 심사는 각자 진행해야 하며, 신청 방법과 준비 서류는 문서에 정리되어 있습니다. 그리고 결제 모듈이 어댑터 구조라 PG에 종속되지 않습니다 — 토스 심사가 늦어지거나 반려되면 포트원으로 갈아타고 출시할 수 있도록 포트원 구현체를 준비하고 있습니다.
구매자 1인이 개인·상업 프로젝트에 무제한으로 사용할 수 있습니다. 소스 코드 자체의 재판매·재배포(공개 저장소 업로드, 유사 보일러플레이트 판매 포함)만 금지됩니다.
소스 코드 특성상 다운로드 이후에는 환불이 어렵습니다. 구매 전에 라이브 데모와 문서 목차를 충분히 확인해주세요. 궁금한 점은 구매 전에 메일로 물어보시면 답해드립니다.