// the find
nuxt-modules/supabase
Supabase module for Nuxt.
A Nuxt module that wires up the Supabase JS client for both client and server-side use in Nuxt 3/4 apps. It handles the SSR complexity of maintaining a consistent auth session across client and server, which is the genuinely hard part of using Supabase with a universal renderer. For anyone building a Nuxt app on Supabase, this removes a week of boilerplate.
The isomorphic client setup is the real value here — separate `useSupabaseClient` for the browser and `serverSupabaseClient`/`serverSupabaseServiceRole` for Nitro routes, with cookies handling session hydration across the SSR boundary. Auth redirect is handled as a plugin with a `useSupabaseCookieRedirect` composable, which is the right approach for SSR-safe redirects. The module is maintained under the official nuxt-modules org with Renovate and CI configured, so it tracks Nuxt and Supabase JS SDK releases promptly. Nuxt 4 support is already in.
Test coverage is thin — there's one test file (`module.test.ts`) that almost certainly just checks the module loads, not that auth flows actually work end-to-end. The cookie-based session approach can cause subtle bugs when Supabase's token refresh races with SSR rendering; there's a `fetch-retry` util that hints this has bitten people before. The module's surface area is entirely dependent on Supabase's own JS SDK design decisions, so if Supabase changes their auth model (they have, twice), you're at their mercy. No real-time subscription helpers are included — you have to wire those up yourself against the raw client.