구성

구성을 한 번 변경하고 확인하세요.

실행 중인 웹 앱으로 시작하세요. 편집기에서 apps/web/.env.local를 엽니다. 존재하지 않는 경우 웹 튜토리얼을 사용하여 .env.example을 복사하십시오. 무해한 첫 번째 확인을 위해 EMAIL_PROVIDER=local를 찾아서 로컬에 두십시오. 이 설정은 실제 받은 편지함 대신 로컬 미리 보기로 제품 이메일을 보냅니다. KEY=value 라인을 터미널에 붙여넣지 마십시오.

활성화한 각 서비스에 대해 해당 공급자의 설정 가이드에 따라 명명된 값만 바꾸고 파일을 저장한 후 Ctrl + C를 사용하여 웹 서버를 중지하고 아래 명령을 사용하여 다시 시작하세요. 유효성 검사에서 누락된 키의 이름이 지정되면 이 파일을 다시 열고 해당 키를 공급자 가이드와 비교하세요. 데이터베이스 마이그레이션에 사용되는 값에 대해서만 루트 .env를 동기화된 상태로 유지하세요. 단독으로 복사하면 Next.js가 구성되지 않습니다.

• 구성 키 조회
• 명령어 실행 및 파일 편집 방법 알아보기

corepack pnpm --filter @supastack/web dev

실제로 먼저 편집하게 될 설정

저장소 루트의 .env.example은 킷이 이해하는 설정의 전체 목록입니다. 그 파일에 없는 이름은 존재하지 않습니다. 처음에는 몇 개만 건드립니다 — 나머지는 공급자 가이드가 요청할 때까지 기본값에 머뭅니다.

각 앱이 읽는 파일: 루트 .env는 마이그레이션 명령에 공급하고, apps/web/.env.local은 Next.js 서버에, apps/mobile/.env.local은 Expo에 공급합니다. 한 파일을 편집해도 다른 파일은 구성되지 않으므로 DATABASE_URL은 루트 .env와 apps/web/.env.local 양쪽에 있습니다.

• APP_URL — 앱이 위치한 주소. 로컬에서는 http://localhost:3000, 프로덕션에서는 내 도메인입니다.
• DATABASE_URL — 마이그레이션과 서버가 공유하는 Postgres 연결 문자열입니다.
• AUTH_SECRET과 CREDENTIAL_ENCRYPTION_KEY — 생성되는 시크릿입니다. node scripts/setup-env.mjs가 대신 채웁니다(이 도우미는 웹 저장소와 All Platforms 모노레포에 함께 제공됩니다).
• 공급자 선택자 — EMAIL_PROVIDER, AI_PROVIDER, BILLING_PROVIDER, JOB_PROVIDER, CAPTCHA_PROVIDER — 각각 어떤 어댑터가 실행될지 고릅니다. local/fake/off 기본값은 계정이 필요 없습니다.
• RESEND_API_KEY나 STRIPE_SECRET_KEY 같은 공급자 시크릿 — 맞는 공급자 가이드가 알려줄 때만 추가하세요.

환경 예제부터 시작

루트 .env.example이 구성 목록입니다. 공유 검증은 packages/config에 있습니다. 선택한 앱 환경과 프로바이더 모드를 함께 검토하세요. 로컬 인터페이스는 프로덕션 자격 증명 전략이 아닙니다.

자격 증명 없는 참조 모드는 local/test 앱 설정과 fake/로컬 프로바이더를 요구합니다. 프로덕션 프로바이더를 선택하면 런타임 요구 사항이 바뀝니다.

시크릿을 API 뒤에 유지

인증 시크릿, 데이터베이스 자격 증명, 프로바이더 키, Stripe 시크릿, Trigger 자격 증명은 서버 전용입니다. NEXT_PUBLIC_ 또는 EXPO_PUBLIC_ 접두사를 붙이지 마세요. 설치 중에 표시하거나 오류 응답에 포함하지 마세요.

브라우저는 공개 구성과 허용된 모델 별칭을 받습니다. 워크스페이스 소유권, 권한 결정, 예산, 프로바이더 선택은 서버에서 강제된 상태로 유지됩니다.

사용하기 전에 변경 사항 검증

기존 config 패키지를 통해 구성을 검증하고 관련 결정적 테스트를 실행하세요. 실제 통합을 검증할 준비가 되면 별도의 옵트인 프로바이더 스모크 경로를 사용하세요.

corepack pnpm test
corepack pnpm check
corepack pnpm build