Next.js + Supabase Auth

Integração especializada do Supabase Auth com o App Router do Next.js

Capacidades

• nextjs-auth
• supabase-auth-nextjs
• auth-middleware
• auth-callback

Pré-requisitos

• Habilidades necessárias: nextjs-app-router, supabase-backend

Padrões

Configuração do Cliente Supabase

Crie clientes Supabase devidamente configurados para diferentes contextos

Quando usar: Ao configurar a autenticação em um projeto Next.js

// lib/supabase/client.ts (Cliente do Navegador) 'use client' import { createBrowserClient } from '@supabase/ssr'

export function createClient() { return createBrowserClient( process.env.NEXT_PUBLIC_SUPABASE_URL!, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY! ) }

// lib/supabase/server.ts (Cliente do Servidor) import { createServerClient } from '@supabase/ssr' import { cookies } from 'next/headers'

export async function createClient() { const cookieStore = await cookies() return createServerClient( process.env.NEXT_PUBLIC_SUPABASE_URL!, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!, { cookies: { getAll() { return cookieStore.getAll() }, setAll(cookiesToSet) { cookiesToSet.forEach(({ name, value, options }) => { cookieStore.set(name, value, options) }) }, }, } ) }

Middleware de Autenticação

Proteja rotas e atualize sessões no middleware

Quando usar: Quando você precisa de proteção de rota ou atualização de sessão

// middleware.ts import { createServerClient } from '@supabase/ssr' import { NextResponse, type NextRequest } from 'next/server'

export async function middleware(request: NextRequest) { let response = NextResponse.next({ request })

const supabase = createServerClient( process.env.NEXT_PUBLIC_SUPABASE_URL!, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!, { cookies: { getAll() { return request.cookies.getAll() }, setAll(cookiesToSet) { cookiesToSet.forEach(({ name, value, options }) => { response.cookies.set(name, value, options) }) }, }, } )

// Atualiza a sessão se expirada const { data: { user } } = await supabase.auth.getUser()

// Protege rotas do dashboard if (request.nextUrl.pathname.startsWith('/dashboard') && !user) { return NextResponse.redirect(new URL('/login', request.url)) }

return response }

export const config = { matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'], }

Rota de Callback de Autenticação

Lida com o callback do OAuth e troca o código por uma sessão

Quando usar: Ao usar provedores OAuth (Google, GitHub, etc.)

// app/auth/callback/route.ts import { createClient } from '@/lib/supabase/server' import { NextResponse } from 'next/server'

export async function GET(request: Request) { const { searchParams, origin } = new URL(request.url) const code = searchParams.get('code') const next = searchParams.get('next') ?? '/'

if (code) { const supabase = await createClient() const { error } = await supabase.auth.exchangeCodeForSession(code) if (!error) { return NextResponse.redirect(${origin}${next}) } }

return NextResponse.redirect(${origin}/auth/error) }

Autenticação em Server Actions

Lida com operações de autenticação em Server Actions

Quando usar: Login, logout ou cadastro a partir de Server Components

// app/actions/auth.ts 'use server' import { createClient } from '@/lib/supabase/server' import { redirect } from 'next/navigation' import { revalidatePath } from 'next/cache'

export async function signIn(formData: FormData) { const supabase = await createClient() const { error } = await supabase.auth.signInWithPassword({ email: formData.get('email') as string, password: formData.get('password') as string, })

if (error) { return { error: error.message } }

revalidatePath('/', 'layout') redirect('/dashboard') }

export async function signOut() { const supabase = await createClient() await supabase.auth.signOut() revalidatePath('/', 'layout') redirect('/') }

Obter Usuário em Server Component

Acesse o usuário autenticado em Server Components

Quando usar: Ao renderizar conteúdo específico do usuário no lado do servidor

// app/dashboard/page.tsx import { createClient } from '@/lib/supabase/server' import { redirect } from 'next/navigation'

export default async function DashboardPage() { const supabase = await createClient() const { data: { user } } = await supabase.auth.getUser()

if (!user) { redirect('/login') }

return ( <div>

…