Open SaaS 2.0 - 무료 오픈소스 SaaS 스타터 키트

새로운 SaaS 앱에 오신 것을 환영합니다! 🎉

Open SaaS 템플릿으로 SaaS 앱을 구축하기로 결정하셨군요. 아주 좋은 선택입니다!

이 템플릿은 다음과 같습니다:

1. 완전한 오픈소스(open-source)
2. 사용 및 배포가 완전히 무료입니다.
3. 기본 기능들이 많이 포함되어 있습니다!
4. 좋아하는 AI 코딩 도구나 에이전트(Claude Code, Cursor, Codex, OpenCode 등)와 작업할 준비가 되어 있습니다.

🧑‍💻 작동하는 모습을 여기서 확인하세요: OpenSaaS.sh
📚 문서는 여기서 확인하세요: Open SaaS Docs

무엇이 들어있나요?

이 템플릿 자체는 다음과 같은 매우 강력한 도구와 프레임워크를 기반으로 구축되었습니다:

• 🐝 Wasp - 강력한 기능을 갖춘 풀스택 React, NodeJS, Prisma 프레임워크
• 🚀 Astro - 문서화 및 블로그를 위한 Astro의 경량 'Starlight' 템플릿
• 💸 Stripe, Polar.sh, 또는 Lemon Squeezy - 제품 및 결제용
• 💅 ShadCN UI - 컴포넌트 및 스타일링용 (관리자 대시보드 포함!)
• 🤖 AI-Ready - Claude Code, Cursor 또는 선호하는 AI 지원 코딩 도구와 함께 AI 지원 코딩을 위한 사용자 지정 플러그인(Custom Plugins), 스킬(Skills) 및 규칙(Rules)
• 📈 Plausible 또는 Google 분석
• 🤖 OpenAI - 함수 호출 예제가 포함된 OpenAI API
• 📦 AWS S3 - 파일 업로드용
• 📧 SendGrid, MailGun, 또는 SMTP - 이메일 전송용
• 🧪 Playwright - Playwright를 사용한 엔드투엔드 테스트(end-to-end tests)

Wasp를 풀스택 프레임워크로 사용하기 때문에, 다음을 포함하여 기록적인 시간 안에 SaaS를 구축하는 데 많은 기능을 활용할 수 있습니다:

• 🔐 풀스택 인증(Full-stack Authentication) - 몇 줄의 코드로 이메일 인증 및 소셜 인증(social Auth) 구현.
• ⛑ 엔드투엔드 타입 안정성(End-to-end Type Safety) - 백엔드 함수를 작성하고, 서드파티 라이브러리를 설치하거나 구성할 필요 없이 프론트엔드에서 자동으로 추론된 타입을 얻을 수 있습니다. 아, 그리고 타입 안정성이 적용된 링크(type-safe Links)도 가능합니다!
• 🤖 작업(Jobs) - 설정 파일에 함수를 정의하는 것만으로 백그라운드에서 크론 작업(cron jobs)을 실행하거나 큐(queues)를 간단하게 설정할 수 있습니다.
• 🚀 원클릭 배포(One-command Deploy) - CLI를 통해 Railway 또는 Fly.io에 DB, 서버 및 클라이언트를 한 번의 명령어로 쉽게 배포할 수 있습니다. 또는 원하는 다른 호스팅 서비스에 수동으로 배포할 수도 있습니다.

막히거나 도움이 필요할 때 Wasp의 다양하고 유용한 커뮤니티에 접속할 수도 있습니다.

• 🤝 Wasp Discord

시작하기 (Getting Started)

간단한 지침 (Simple Instructions)

먼저, macOS, Linux 또는 WSL을 사용하는 Windows에 최신 버전의 Wasp를 설치하려면 다음 명령어를 실행하세요:

npm i -g @wasp.sh/wasp-cli

그런 다음, 다음 명령어로 새로운 SaaS 앱을 만드세요:

wasp new -t saas

이렇게 하면 Open SaaS 템플릿의 깨끗한 복사본이 새 디렉터리에 생성되며, 바로 SaaS 앱 개발을 시작할 수 있습니다!

상세 지침 (Detailed Instructions)

시작하는 방법과 이 템플릿 사용에 대해 알아야 할 모든 것은 Open SaaS Docs를 확인하세요.

설치 지침, 템플릿 업데이트 가져오기(pulling updates), 서비스 통합 가이드, SEO, 배포 등 모든 것을 매우 상세하게 문서화했습니다. 🚀

도움 받기 및 피드백 제공하기 (Getting Help & Providing Feedback)

도움을 받거나 피드백을 제공하는 방법은 두 가지가 있습니다(그리고 저희는 항상 빠르게 응답하려고 노력합니다!):

1. 이슈 열기
2. Wasp Discord -- 질문은 #🙋questions 포럼 채널로 보내주세요.

개발 도구 (Development Tools)

코드 품질 도구 (Code Quality Tools)

이 리포지토리에는 코드 표준을 유지하는 데 도움이 되는 포괄적인 코드 품질 도구가 포함되어 있습니다:

Prettier (코드 포매팅)

Prettier는 모든 JavaScript, TypeScript 및 기타 지원되는 파일에 걸쳐 자동 코드 포매팅을 위해 구성되었습니다.

# 파일이 올바르게 포매팅되었는지 확인
npm run prettier:check

...

ESLint (코드 린팅)

ESLint는 잠재적인 버그를 감지하고 코드 품질 표준을 강제하기 위해 TypeScript 및 React 지원으로 구성되었습니다.

# 문제를 확인하기 위해 ESLint 실행
npm run lint

...

ESLint 설정에는 다음이 포함됩니다:

• @typescript-eslint를 사용한 TypeScript 지원
• React 및 React Hooks 린팅
• SaaS 애플리케이션에 맞게 조정된 합리적인 기본값(Sensible defaults)
• CommonJS(.cjs), ES Modules(.mjs), TypeScript 파일에 대한 자동 지원

Prettier와 ESLint 검사는 코드 품질을 보장하기 위해 CI/CD 파이프라인에서 자동으로 실행됩니다.

파생 프로젝트(예: opensaas.sh 및 template-test)를 유지하는 데 사용된 다른 개발 도구에 대한 정보는 tools/README.md를 참조하세요.

기여 (Contributing)

이 템플릿에 SaaS 앱의 핵심 기능 대부분을 담으려고 노력했지만, 여전히 누락된 기능이나 기능이 있을 수 있다는 점에 유의해 주세요.

느슨한 부분을 정리하는 데 도움이 필요할 때 언제든지 도움을 주실 수 있습니다. 기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 확인하세요.