utils-auth-supabase
Installation
SKILL.md
Utils — Auth, Supabase, CORS
utils/ is server-only except utils/supabase/client.ts. Never import utils/auth.ts in client components.
Supabase client matrix
| File | Export | Use when |
|---|---|---|
utils/supabase/server.ts |
async createClient() |
Server Components, route handlers (cookie session via next/headers) |
utils/supabase/client.ts |
createClient() |
Browser client components |
utils/supabase/service.ts |
createServiceClient() |
Server DB writes; bypasses RLS; requires SUPABASE_SERVICE_ROLE_KEY |
proxy.ts |
inline createServerClient |
Early session refresh + redirects only |
utils/supabase/server.ts setAll silently catches errors when called from Server Components — cookie writes only work in Route Handlers / proxy.ts.