@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.
Instalação
npm install @clowk/react @clowk/coreVisão geral
Bindings React para o Clowk. Oferece um context provider, hooks e componentes prontos para os fluxos de autenticação.
O que ele oferece:
ClowkProvider— context provider que inicializa o SDKuseUser()— acesso ao usuário autenticado atualuseSession()— acesso à sessão atualuseAuth()— ações de autenticação (entrar, sair)SignInButton/SignOutButton— botões prontos de UI
ClowkProvider
Envolva seu app com ClowkProvider para inicializar o SDK:
import { ClowkProvider } from '@clowk/react'
function App() {
return (
<ClowkProvider publishableKey="pk_live_...">
<YourApp />
</ClowkProvider>
)
}useUser
Retorna o usuário autenticado atual ou null:
import { useUser } from '@clowk/react'
function Profile() {
const { user, isLoaded } = useUser()
if (!isLoaded) return <div>Loading...</div>
if (!user) return <div>Not signed in</div>
return <div>Hello, {user.name}</div>
}Tipo de retorno
| Campo | Tipo | Descrição |
|---|---|---|
user | User | null | O objeto do usuário autenticado |
isLoaded | boolean | Se o estado do usuário já foi resolvido |
useSession
Retorna a sessão atual:
import { useSession } from '@clowk/react'
function SessionInfo() {
const { session, isLoaded } = useSession()
if (!isLoaded) return null
return <div>Session ID: {session?.id}</div>
}useAuth
Ações de autenticação:
import { useAuth } from '@clowk/react'
function AuthControls() {
const { signIn, signOut, isSignedIn } = useAuth()
if (isSignedIn) {
return <button onClick={signOut}>Sign out</button>
}
return <button onClick={() => signIn('google')}>Sign in with Google</button>
}Provedores disponíveis
Passe o nome de um provedor para signIn():
signIn('google')
signIn('github')
signIn('apple')
signIn('microsoft')Próximos passos
- Quickstart do React — guia para começar
- Referência do @clowk/core — pacote base
@clowk/sdk
@clowk/sdk reexporta tudo do @clowk/core em um único caminho de import, para apps JavaScript que querem uma só dependência para a autenticação com Clowk.
@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.