@clowk/nextjs

@clowk/nextjs adiciona autenticação com Clowk a apps Next.js com App Router: middleware de rotas, currentUser() em Server Components e hooks no cliente.

Instalação

npm install @clowk/nextjs @clowk/core

Visão geral

Integração completa com Next.js e suporte ao App Router. Oferece middleware, server components e hooks de cliente.

O que ele oferece:

  • clowkMiddleware() — middleware Next.js para proteger rotas
  • currentUser() — função do lado do servidor para obter o usuário autenticado
  • ClowkProvider — provider do lado do cliente (reexportado de @clowk/react)
  • useUser(), useAuth() — hooks de cliente (reexportados de @clowk/react)

Middleware

Proteja rotas com o middleware do Next.js:

middleware.ts
import { clowkMiddleware } from '@clowk/nextjs/server'

export default clowkMiddleware()

export const config = {
  matcher: [
    '/((?!_next|[^?]*\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)',
  ],
}

Lógica de middleware personalizada

middleware.ts
import { clowkMiddleware } from '@clowk/nextjs/server'

export default clowkMiddleware((auth, req) => {
  const { userId } = auth()

  if (!userId && req.nextUrl.pathname.startsWith('/dashboard')) {
    return auth().redirectToSignIn()
  }
})

Server Components

Acesse o usuário em server components:

app/dashboard/page.tsx
import { currentUser } from '@clowk/nextjs/server'

export default async function DashboardPage() {
  const user = await currentUser()

  if (!user) return <div>Not signed in</div>

  return <div>Welcome, {user.name}</div>
}

Client Components

Use hooks em client components:

components/user-button.tsx
'use client'

import { useUser, useAuth } from '@clowk/nextjs'

export function UserButton() {
  const { user } = useUser()
  const { signOut } = useAuth()

  if (!user) return null

  return (
    <button onClick={signOut}>
      {user.name} — Sign out
    </button>
  )
}

Variáveis de ambiente

.env.local
NEXT_PUBLIC_CLOWK_PUBLISHABLE_KEY=pk_live_...
CLOWK_SECRET_KEY=sk_live_...

O pacote Next.js lê essas variáveis sozinho — não precisa chamar configure().

Próximos passos

Nesta página