Troubleshooting
Common setup and runtime issues.
Missing .env.local
Copy .env.example. Run vercel env pull .env.local --yes when linked. Restart pnpm dev.
Supabase missing
App runs in LOCAL DEMO MODE — ventures may save in the browser. /status shows PRESENT/MISSING only.
Build fails
Run pnpm build locally. Fix TypeScript errors before preview or production. See /launch v7.5 packet.
Pre-nav banner above navbar
SubpageVisual was removed in v7.3. If a strip reappears, check for new components above SiteShell nav.
Auth issues
Verify callback URL and Supabase auth settings. Use /sign-in.
Deploy blocked
Production requires operator approval. Use preview (vercel) first; vercel --prod only after /launch checklist.