TanStarter

템플릿은 TanStack Start 위에서 돈다. 파일 기반 라우팅, 서버 함수, 데이터 로딩을 하나의 프레임워크에서 처리한다. 서버 라우트와 클라이언트 라우트가 함께 있어 두 가지 사고 모델을 오갈 필요가 없다. React와 TypeScript를 안다면 학습 부담은 작다.

모든 것이 Cloudflare 엣지 네트워크에 배포된다. Workers는 사용자 가까이에서 돌고, 무료 플랜에서도 비압축 Worker 번들을 최대 64 MiB까지 허용한다. 일반적인 앱에는 차고 넘치는 여유다. D1이 관계형 데이터를, R2가 파일 저장소를 맡고, 두 바인딩 모두 wrangler.jsonc에 선언한다. 이 조합 덕분에 첫 버전을 공개하려고 별도의 데이터베이스 서버나 객체 저장소를 준비할 필요가 없다.

기본은 Stripe지만 결제 모듈이 프로바이더 인터페이스 뒤에 있어 Creem과 Waffo도 쓸 수 있다. 월간과 연간 구독, 평생 단건 결제, 무료 체험이 모두 제공된다. 결제 관리는 Stripe 고객 포털에서 하고, WeChat Pay와 Alipay는 Stripe 설정에서 켜면 사용할 수 있다.

Cloudflare Workers AI와 Fal.ai가 기본 제공되는 AI 기능을 뒷받침한다. 요약이나 생성 같은 기능을 다른 벤더 계정을 열지 않고 추가할 수 있다. AI 계층은 선택 사항이라 제품에 필요 없으면 꺼두면 된다.

사용자 계정과 세션은 미리 설정되어 있다. 이메일, 뉴스레터, 알림 모듈은 결제와 같은 프로바이더 패턴을 공유하므로 서비스를 바꾸는 방식이 일관된다. 가입, 영수증, 비밀번호 재설정을 위한 트랜잭션 이메일이 첫날부터 작동한다.

제목, 설명, 날짜, 카테고리, 이미지 프런트매터를 붙인 Markdown 파일을 content/blog/에 넣으면 블로그 페이지에 자동으로 나타난다. 별도 CMS를 붙이지 않고도 SEO용 콘텐츠 경로를 확보하는 셈이다.

Google Analytics, Umami, Plausible, Microsoft Clarity를 지원하며 어떤 조합으로든 돌릴 수 있다. 환경 변수를 설정하면 프로덕션에서 켜진다. 별도의 추적 코드는 필요 없다.

템플릿 저장소를 Git 원격으로 추가하고 페치한 뒤 병합하면 상위 프로젝트의 개선 사항을 가져올 수 있다. 충돌을 해결한 뒤 pnpm install을 실행하고 새 마이그레이션을 적용한 다음 테스트한다. 내 사본을 최신으로 유지하는 일은 마이그레이션 프로젝트가 아니라 일상적인 병합으로 끝난다.