3.4 KiB
3.4 KiB
Launch Secrets Checklist
Last updated: 2026-05-12
This file is the operator-facing checklist for filling the launch env files before deploy.
Preferred file layout:
- staging:
.env.gitgram.staging,.env.gitgram-web.staging,.env.aitm-api.staging - production:
.env.gitgram.production,.env.gitgram-web.production,.env.aitm-api.production
Fallback layout:
.env.gitgram.env.gitgram-web.env.aitm-api
Current gate:
npm run verify:launchfor deployable core readinessnpm run verify:launch:fullfor all third-party integrations live
Polar reference:
docs/polar-payment-setup.md
Current state:
- deploy/readiness scripts are in place
- AITM package dry-run verification passes
- dedicated Neon databases now exist for
gitgram_staging,gitgram_production,aitm_staging, andaitm_production - root staging/production env files now contain real database URLs and generated app-owned secrets
- full-integration launch is still blocked by provider-issued values, not local infra placeholders
Gitgram Backend Env
App-owned values now set:
DATABASE_URLJWT_SECRETJWT_REFRESH_SECRET
Still provider-issued:
REDIS_URLFRONTEND_URLCORS_ORIGINGITHUB_CLIENT_IDGITHUB_CLIENT_SECRETPOLAR_ACCESS_TOKENPOLAR_MODEPOLAR_WEBHOOK_SECRETPOLAR_PREMIUM_PRODUCT_IDPOLAR_CREATOR_PRODUCT_IDRESEND_API_KEYSENTRY_DSN
Optional depending on storage mode:
AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_S3_BUCKETAWS_REGION
Files:
- staging:
.env.gitgram.staging - production fallback:
.env.gitgramor.env.gitgram.production
Gitgram Web Env
Confirm or fill:
NEXT_PUBLIC_API_URLNEXT_PUBLIC_WS_URLNEXT_PUBLIC_GITHUB_CLIENT_IDNEXT_PUBLIC_GOOGLE_CLIENT_IDNEXT_PUBLIC_AITM_API_URLNEXT_PUBLIC_SENTRY_DSN
Files:
- staging:
.env.gitgram-web.staging - production fallback:
.env.gitgram-webor.env.gitgram-web.production
AITM API Env
App-owned values now set:
DATABASE_URLINTERNAL_SECRET
Still provider-issued:
CORS_ORIGINWEBSITE_URLPOLAR_ACCESS_TOKENPOLAR_MODEPOLAR_WEBHOOK_SECRETPOLAR_PRO_PRODUCT_IDPOLAR_TEAM_PRODUCT_IDRESEND_API_KEYSENTRY_DSN
Optional:
CLERK_WEBHOOK_SECRETREDIS_URLOPENAI_API_KEYANTHROPIC_API_KEYVOYAGE_API_KEYBRAVE_SEARCH_API_KEY
Files:
- staging:
.env.aitm-api.staging - production fallback:
.env.aitm-apior.env.aitm-api.production
Provider Mapping
GitHub OAuth:
GITHUB_CLIENT_IDGITHUB_CLIENT_SECRETNEXT_PUBLIC_GITHUB_CLIENT_ID
Polar:
- Gitgram:
POLAR_ACCESS_TOKEN,POLAR_MODE,POLAR_WEBHOOK_SECRET,POLAR_PREMIUM_PRODUCT_ID,POLAR_CREATOR_PRODUCT_ID - AITM:
POLAR_ACCESS_TOKEN,POLAR_MODE,POLAR_WEBHOOK_SECRET,POLAR_PRO_PRODUCT_ID,POLAR_TEAM_PRODUCT_ID
Email:
RESEND_API_KEY
Monitoring:
SENTRY_DSNNEXT_PUBLIC_SENTRY_DSN
Core infra:
- Gitgram:
DATABASE_URL,REDIS_URL,JWT_SECRET,JWT_REFRESH_SECRET - AITM:
DATABASE_URL,INTERNAL_SECRET
Deploy Sequence
- Run
npm run verify:launchfor the core deploy gate. - Run
bash scripts/deploy-launch.sh staging --gitgram-only. - Run
bash scripts/deploy-launch.sh staging --aitm-only. - Configure nginx and DNS if not already live.
- Run
npm run verify:public-launch. - Once OAuth, Polar, Resend, and Sentry are configured, run
npm run verify:launch:full.