@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/coreVisã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 rotascurrentUser()— função do lado do servidor para obter o usuário autenticadoClowkProvider— 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:
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
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:
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:
'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
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
- Quickstart do Next.js — guia para começar
- Referência do @clowk/react — hooks e componentes de cliente
- Referência do @clowk/core — pacote base
@clowk/react
@clowk/react traz autenticação com Clowk para apps React: ClowkProvider, os hooks useUser, useSession e useAuth, e botões prontos de login e logout.
@clowk/express
@clowk/express é o middleware Express para autenticação com Clowk: verifica o JWT, define req.clowk.user e permite customizar extração do token e erros.