@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/core

Visã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 SDK
  • useUser() — acesso ao usuário autenticado atual
  • useSession() — acesso à sessão atual
  • useAuth() — 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

CampoTipoDescrição
userUser | nullO objeto do usuário autenticado
isLoadedbooleanSe 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

Nesta página