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