콘텐츠로 건너뛰기
supastack
문서 둘러보기
웹Next.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/mobile/external-accounts.md (or send Accept: text/markdown).

모바일 계정 만들기

Expo, Apple, Google Play, RevenueCat 계정—각각의 용도와 생성 시기.

이 가이드에 대해 질문하기
다음에서 열기

이것들이 필요한 경우

일상적인 모바일 설정에는 이것들이 전혀 필요하지 않습니다. Expo Go와 실행 중인 백엔드—apps/mobile/.env.local의 EXPO_PUBLIC_API_URL—가 화면 미리보기와 로그인 테스트를 커버합니다.

Expo Go를 넘어설 때 이 계정들을 만듭니다. Expo 계정은 EAS 클라우드 빌드를 구동하고, 스토어 계정은 제출을 가능하게 하고, RevenueCat은 네이티브 구매를 검증하고, Apple의 프로그램은 스토어 심사 중 Sign in with Apple에도 필요합니다. 이 중 두 개는 비용이 듭니다. Apple Developer는 연간 $99, Google Play는 일회성 $25 등록입니다. Expo와 RevenueCat에는 모두 무료 등급이 있습니다.

Expo + EAS

1. expo.dev → Sign up(가입)을 열고 계정을 만들고 이메일을 확인합니다.

2. 터미널에서 npx eas-cli@latest login을 실행하고 같은 자격 증명을 입력합니다—eas는 Expo Application Services 빌드와 제출을 위한 명령줄 도구입니다.

3. apps/mobile 폴더에서 npx eas-cli@latest init을 실행하여 코드베이스를 EAS 프로젝트에 연결합니다. 프로젝트 ID가 app.json/app.config.ts 구성에 기록됩니다. eas.json 빌드 프로필은 이미 포함되어 있습니다.

예상 결과: npx eas-cli@latest whoami가 계정 이름을 출력하고 expo.dev 대시보드에 프로젝트가 표시됩니다.

npx eas-cli@latest login
cd apps/mobile
npx eas-cli@latest init
npx eas-cli@latest whoami

Apple Developer Program

1. developer.apple.com → Account(계정)를 열고 Apple Developer Program에 등록합니다—연간 $99. 개인 멤버십이면 됩니다.

2. 등록에는 이중 인증이 활성화된 Apple ID와 결제 수단과 일치하는 법적 이름이 필요합니다. 승인에는 하루 이틀 걸릴 수 있습니다.

3. 이 하나의 계정으로 두 가지 요구 사항을 충족합니다. App Store에 iOS 앱 제출과 Sign in with Apple입니다—App Review는 iOS 앱이 Google이나 GitHub 같은 타사 소셜 로그인을 제공할 때마다 Sign in with Apple 제공을 요구합니다. 킷은 백엔드의 AUTH_APPLE_ENABLED와 APPLE_CLIENT_ID/APPLE_CLIENT_SECRET 쌍으로 이를 연결합니다.

같은 멤버십은 macOS 데스크톱 서명도 커버합니다—데스크톱 계정 가이드가 그 측면을 설명합니다.

Google Play Console

1. play.google.com/console을 열고 일회성 $25 등록비를 지불하고 본인 또는 회사 명의로 개발자 계정을 만듭니다.

2. 지금은 개발자 계정에서 멈춥니다—앱 항목 자체는 제출 시 Play Console 내부에서 생성됩니다. 새 앱의 첫 업로드는 항상 거기서 수동으로 이루어지고, 두 번째 릴리스부터는 eas submit이 이어받습니다.

RevenueCat—앱이 콘텐츠를 판매하는 경우에만

모바일 앱이 디지털 콘텐츠나 구독을 판매하지 않으면 이 섹션을 완전히 건너뛰세요. 판매하는 경우: 1. revenuecat.com을 열고 무료 계정을 만듭니다. 2. 프로젝트를 만듭니다. 3. 그 안에 iOS 앱(App Store Connect에 연결)과 Android 앱(Play 패키지 이름과 서비스 자격 증명)을 등록합니다.

4. 스토어 제품과 일치하는 제품 및 인타이틀먼트를 만듭니다—킷은 액세스를 부여하기 전에 구성된 인타이틀먼트(REVENUECAT_ENTITLEMENT_ID, REVENUECAT_ENTITLEMENT_KEY)를 서버 측에서 확인합니다.

5. 각 플랫폼의 공개 SDK 키를 apps/mobile/.env.local에 복사하고 아래와 같이 양쪽에서 공급자를 활성화합니다. SDK 키는 공개 클라이언트 값입니다. REVENUECAT_SECRET_API_KEY와 REVENUECAT_WEBHOOK_AUTHORIZATION은 서버 전용이며 백엔드 환경에 속합니다—EXPO_PUBLIC_ 변수에는 절대 넣지 마세요.

# apps/mobile/.env.local
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=revenuecat
EXPO_PUBLIC_REVENUECAT_IOS_API_KEY=your-public-ios-sdk-key
EXPO_PUBLIC_REVENUECAT_ANDROID_API_KEY=your-public-android-sdk-key

# apps/web/.env.local — server side
MOBILE_PURCHASES_PROVIDER=revenuecat
REVENUECAT_SECRET_API_KEY=your-secret-api-key
REVENUECAT_WEBHOOK_AUTHORIZATION=your-webhook-auth-value

모바일의 로그인 공급자

모바일 로그인은 웹용으로 만든 것과 같은 Google 및 GitHub OAuth 앱을 재사용합니다—Better Auth가 서버 측을 처리하므로 콜백은 {APP_URL}/api/auth/callback/<provider>로 유지되고, 앱은 EXPO_PUBLIC_APP_SCHEME 딥링크 스킴을 통해 돌아옵니다. 클라이언트가 네이티브라고 해서 추가 공급자 앱이 필요하지는 않습니다.

예외는 iOS 스토어 심사입니다. iOS에서 Google이나 GitHub 버튼을 출시하려면 Sign in with Apple도 제공해야 하므로, 위의 Apple Developer 계정이 로그인 종속성을 겸하는 것입니다.

완료 기준

계속하기 전에 각 계정을 확인하세요. npx eas-cli@latest whoami가 Expo 계정을 출력하고 대시보드에 프로젝트가 표시되고, Apple Developer 멤버십이 Active(활성)로 표시되고, Play Console 계정이 존재하고, RevenueCat 프로젝트에 두 스토어 앱과 제품 및 인타이틀먼트가 나열되어 있고, 그 키가 올바른 env 파일에 있는지 확인합니다.

그런 다음 순서대로 계속합니다—프로젝트 연결, 앱이 콘텐츠를 판매하는 경우 구매 설정, 디바이스용 빌드, 제출:

자주 묻는 질문

질문 14개

supastack이란 무엇인가요?

supastack은 AI SaaS 제품을 구축하기 위한 모듈식 기반입니다. 공통 인프라를 모아두어 제품 고유의 기능에 집중할 수 있습니다.

웹과 모바일을 지원하나요?

네. supastack에는 웹과 모바일 경험의 출발점으로 Next.js 앱과 Expo 앱이 포함되어 있습니다.

어떤 인증이 포함되어 있나요?

Better Auth가 이메일/비밀번호, OTP, 소셜 로그인을 커버합니다. 개인 워크스페이스는 계정과 함께 프로비저닝되어 첫날부터 레코드가 경계 안에 유지됩니다.

AI는 어떻게 지원되나요?

supastack에는 구성 가능한 멀티 프로바이더 AI, 사용량 추적, 예산, 암호화된 자체 키(BYOK) 지원이 포함되어 있습니다.

구독은 어떻게 관리되나요?

이 키트 위에 구축된 제품에서는 Stripe 결제, 구독, 권한이 유료 액세스의 기반을 형성합니다. 프로바이더 시크릿은 서버 측에 유지됩니다.

제품 고유 코드는 어디에 두나요?

제품 고유 기능은 별도의 코드베이스에 두고, 제품이 supastack 기본 모듈을 구성하고 통합합니다.

supastack 가격은 어떻게 되나요?

키트는 평생 업데이트가 포함된 일회성 구매입니다: 단일 프레임워크 $249(기간 한정 출시 가격 — 정가 $349에서 $100 할인) 또는 모든 프레임워크(Next.js, iOS, Android) $499(기간 한정 출시 가격 — 정가 $599에서 $100 할인), 추가 개발자 시트당 $75. 키트 구독은 없습니다. 이 사이트의 체크아웃은 라이선스 키를 이메일로 전달하고 GitHub 초대로 리포지토리 액세스를 제공합니다.

워크스페이스는 내 데이터를 어떻게 경계 짓나요?

사용자 레코드는 workspaceId로 범위가 지정됩니다. 신원, 권한, AI 사용량, 결제 이벤트, 감사 항목은 개인 워크스페이스 경계 안에 유지됩니다.

백그라운드 작업은 어떻게 작동하나요?

Trigger.dev가 명시적인 작업 런타임입니다. JobRunner 계약은 enqueue, status, cancel만 약속하며 — 워크플로 의미는 Trigger.dev 고유이고 명시적입니다.

이메일과 아웃리치는 어떻게 다른가요?

트랜잭션 이메일은 작업 완료 알림 같은 제품 워크플로를 커버합니다. 콜드 아웃리치와 캠페인은 제품 자체에 속하며 이 키트의 이메일 모듈 밖입니다.

모바일 구매는 어떻게 작동하나요?

모바일은 RevenueCat 네이티브 구매와 복원을 지원하며 서버에서 접근 권한을 검증합니다. 출시 전에 스토어 계정을 설정하고 기기 테스트를 완료하세요. 웹 결제는 별도로 관리합니다.

AI 프로바이더 키는 어디에 있나요?

BYOK 자격 증명은 암호화되어 서버 측에 유지됩니다. 키는 로그에서 삭제되며, 사용량과 예산은 워크스페이스 수준에서 확인할 수 있습니다.

체크아웃에서 어떤 결제 수단을 지원하나요?

Stripe 호스팅 체크아웃은 카드를 받으며, Stripe 계정에서 지갑을 활성화하면 Alipay와 WeChat Pay도 제공할 수 있습니다 — 중국 구매자에게 유용합니다. 지갑 승인은 비동기로 확정되므로 결제가 완료되는 즉시 라이선스 페이지가 갱신됩니다.

환불을 받을 수 있나요?

저장소 접근 권한을 얻은 후에는 supastack이 영구적으로 귀하의 소유가 되므로 환불이 불가능합니다. 하지만 안심하세요. 평생 업데이트가 포함된 전체 소스 코드를 받아 자신이나 고객을 위한 제품을 무제한으로 구축하고 출시할 수 있습니다. 단, 코드를 재판매하거나 저장소를 스타터 키트 또는 템플릿으로 재배포할 수는 없습니다.

KO
테마