Debugging guide · 22 verified fixes

Start here if your Next.js + Supabase app breaks in production

Pick your symptom below. Each path leads to a verified fix with code you can copy and steps you can follow. No generic advice.

Want the full checklist?

Next.js + Supabase Production Debugging Checklist — free download

Get it

Server Components / SSR session

Session null in Server Components, use client vs use server confusion, dynamic rendering errors.

Realtime

Subscription not receiving events, channel lifecycle issues, replication not enabled.

Don't see your issue?

Search across all guides and articles, or browse by topic hub.