Service Management Reference
Reference for deployment, environment, and operations.
Deployment
The web app runs on Node.js (Next.js) and can be deployed via Docker or a Node host. See docs/DEPLOY-HOSTINGER-VPS.md for Hostinger VPS and Docker. Build: npm run build. Start: npm run start (port 3001).
Environment
Required env: DATABASE_URL, NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, NEXT_PUBLIC_APP_URL. Optional: SUPABASE_SERVICE_ROLE_KEY, STRIPE_*, Cloudflare_* (Tunnel, etc.).
Login / Captcha errors
Login/signup uses Supabase Auth; no captcha in the app. If you see "captcha verification process failed", it comes from Cloudflare (proxy), not the app — fix in Cloudflare Dashboard (see docs/CLOUDFLARE-CAPTCHA-TROUBLESHOOTING.md).
Key Docs
- Deploy (Hostinger VPS):
docs/DEPLOY-HOSTINGER-VPS.md - Auth / OAuth:
docs/AUTH-SIGNIN-PROVIDERS.md,docs/OAUTH-GOOGLE-AZURE-WALKTHROUGH.md,docs/AZURE-AD-SETUP.md - Google OAuth / Brand:
docs/GOOGLE-OAUTH-BRAND-VERIFICATION.md - Troubleshooting:
docs/WEBSITE-NOT-WORKING.md,docs/TROUBLESHOOTING-502-LEARNINGYARD.md,docs/CLOUDFLARE-CAPTCHA-TROUBLESHOOTING.md
