Cloudflare AuthJS Boilerplate
Project Overview
Project Type
Open Source Side Project
License
MIT License
Category
인증 시스템, 클라우드 인프라, 결제 시스템
Project Description
Cloudflare Workers 환경에서 Auth.js (NextAuth)를 사용하는 인증 시스템 보일러플레이트입니다. Next.js 15와 OpenNextJS를 활용하여 Cloudflare에 최적화된 인증 시스템을 구축했으며, Cloudflare D1 데이터베이스를 사용하여 사용자 인증 정보를 저장합니다. 다국어 지원, 결제 처리, 봇 방지 등 현대적인 SaaS 애플리케이션에 필요한 모든 기능을 포함하고 있습니다.
Tech Stack
Frontend
- • Next.js 15 (OpenNextJS 1.0.4)
- • React 19
- • TypeScript
- • Tailwind CSS 3
- • shadcn/ui Components
Backend & Cloud
- • Cloudflare Workers
- • Cloudflare D1 (Serverless RDB)
- • Cloudflare Turnstile
- • Wrangler CLI
Authentication & Services
- • NextAuth 5.0.0-beta
- • Google OAuth
- • Email Magic Link (Resend)
- • Lemon Squeezy (Payment)
- • i18n (Internationalization)
Key Features
Authentication System
- • Cloudflare D1을 통한 사용자 인증 정보 저장
- • Resend를 통한 이메일 매직 링크 인증
- • Google OAuth 인증
- • Cloudflare Turnstile 봇 방지 통합
- • 내장 인증 미들웨어 및 세션 제공자
Payment & Internationalization
- • Lemon Squeezy 결제 처리 및 구독 관리
- • 다국어 지원 (영어, 한국어, 일본어, 스페인어, 중국어)
- • 실시간 언어 전환
- • URL 기반 지역화
Dashboard & UI
- • 반응형 대시보드 UI
- • 인터랙티브 차트 및 데이터 테이블
- • shadcn 컴포넌트 기반 현대적 인터페이스
- • 구독 및 결제 관리 인터페이스
Development & Deployment
- • OpenNextJS를 통한 Cloudflare 배포 최적화
- • TypeScript 지원
- • 자동 데이터베이스 마이그레이션
- • 상세한 설치 가이드 및 문서화
Technical Challenges
서버리스 아키텍처 최적화
Cloudflare Workers와 D1을 활용한 완전한 서버리스 환경에서 인증 시스템을 구축하여 확장성과 비용 효율성을 동시에 확보했습니다.
다국어 지원 시스템
Next.js App Router의 i18n을 활용하여 5개 언어를 지원하는 동적 언어 전환 시스템을 구현했습니다.
결제 시스템 통합
Lemon Squeezy를 통한 안전한 결제 처리와 웹훅 기반의 실시간 구독 관리 시스템을 구축했습니다.
System Architecture
아키텍처 주요 특징
- • 서버리스 아키텍처: Cloudflare Workers를 통한 완전한 서버리스 환경에서 실행
- • 인증 시스템: NextAuth 5를 통한 다중 인증 방식 (Google, Email Magic Link)
- • 데이터베이스: Cloudflare D1을 통한 서버리스 관계형 데이터베이스 활용
- • 결제 시스템: Lemon Squeezy를 통한 안전한 결제 처리 및 구독 관리
- • 다국어 지원: i18n을 통한 5개 언어 지원 및 동적 언어 전환
- • 보안: Cloudflare Turnstile을 통한 봇 방지 및 보안 강화
- • 배포 최적화: OpenNextJS를 통한 Cloudflare 배포 최적화