원문 캡처 · github.com
원문 캡처 · github.com

Staxless는 Next.js 프런트엔드와 Node.js 기반 마이크로서비스, Kong API 게이트웨이, 결제·인증 기능을 묶은 오픈소스 SaaS 보일러플레이트다. Node.js 18 이상, Git, Docker, GitHub CLI가 필요하며 CLI로 프로젝트를 초기화하고 개발 환경을 실행할 수 있다.

Staxless 저장소는 프런트엔드에 Next.js, React, Tailwind CSS, shadcn/ui를 사용하고 인증·사용자·결제·이메일 서비스를 각각 구성한다. 인증에는 Lucia와 Google·GitHub OAuth2를, 결제에는 Stripe 구독과 일회성 구매를 지원한다고 설명한다. 데이터베이스는 MongoDB이며, Docker Compose로 컨테이너를 실행하고 핫 리로딩을 지원한다.

프로젝트를 시작하려면 CLI를 설치하고 초기화한 뒤 개발 서비스를 실행한다.

sh
npm install -g @staxless/cli
staxless init
staxless dev start

실행 후 http://localhost:3000에서 프런트엔드에 접속한다. 프런트엔드 브랜드와 스타일은 staxless setup:frontend로 설정하거나 frontend/config/brand-config.ts와 frontend/config/sales-config.ts를 직접 수정한다. 환경 변수는 템플릿을 복사해 만든다.

sh
cp environments/template.env environments/.env

필수 환경 변수에는 STRIPE_PRIVATE_KEY, Google 및 GitHub OAuth 자격 증명, MONGODB_URI가 포함된다. 전체 서비스 시작·로그 확인·상태 점검·종료·초기화 명령은 다음과 같다.

sh
staxless dev start
staxless dev logs -f
staxless dev status
staxless dev down
staxless dev reset

서비스 포트는 프런트엔드 3000, Kong API 게이트웨이 8000, 인증 8080, 사용자 8082, Stripe 8083, 이메일 8084, MongoDB 27017이다. 운영 배포에는 먼저 시크릿을 설정한 뒤 배포 명령을 사용한다.

sh
staxless setup:prod
staxless prod deploy
staxless prod status

자세한 내용은 CLI 문서에서 확인할 수 있으며, 문제는 GitHub 이슈에 보고할 수 있다.