Better Auth UI

The <AuthUIProvider> wraps your application with authentication context, providing essential hooks, settings, and methods required by authentication-related components and hooks throughout your app.

Usage

providers.tsx

"use client"
 
import { AuthUIProvider } from '@daveyplate/better-auth-ui'
import { authClient } from '@/lib/auth-client'
import { useRouter } from 'next/navigation'
import Link from 'next/link'
 
export function Providers({ children }: { children: React.ReactNode }) {
  const router = useRouter()
 
  return (
    <AuthUIProvider
      authClient={authClient}
      navigate={router.push}
      replace={router.replace}
      onSessionChange={() => router.refresh()}
      Link={Link}
    >
      {children}
    </AuthUIProvider>
  )
}

Reference

The following props can be passed to the <AuthUIProvider> component:

Prop	Type	Default
`passwordValidation?`	`PasswordValidation`	-
`Link?`	`any`	`<a>`
`uploadAvatar?`	`(file: File) => Promise<string>`	-
`replace?`	`((href: string) => void)`	`navigate`
`onSessionChange?`	`(() => void \| Promise<void>)`	-
`navigate?`	`((href: string) => void)`	`window.location.href`
`username?`	`boolean`	`false`
`twoFactor?`	`("otp" \| "totp")[]`	`undefined`
`signInSocial?`	`((params: any) => Promise<unknown>)`	-
`signUpFields?`	`string[]`	`["name"]`
`signUp?`	`boolean`	`true`
`settingsURL?`	`string`	-
`settingsFields?`	`string[]`	`["name"]`
`rememberMe?`	`boolean`	`false`
`otherProviders?`	`Provider[]`	`false`
`providers?`	`SocialProvider[]`	-
`persistClient?`	`boolean`	`false`
`passkey?`	`boolean`	`false`
`optimistic?`	`boolean`	`false`
`oneTap?`	`boolean`	`false`
`noColorIcons?`	`boolean`	`false`
`nameRequired?`	`boolean`	`true`
`multiSession?`	`boolean`	`false`
`emailOTP?`	`boolean`	`false`
`magicLink?`	`boolean`	`false`
`freshAge?`	`number`	`60 * 60 * 24`
`forgotPassword?`	`boolean`	`true`
`emailVerification?`	`boolean`	-
`deleteUser?`	`boolean`	`false`
`changeEmail?`	`boolean`	`true`
`deleteAccountVerification?`	`boolean`	`false`
`redirectTo?`	`string`	`"/"`
`credentials?`	`boolean`	`true`
`confirmPassword?`	`boolean`	`false`
`colorIcons?`	`boolean`	`false`
`captcha?`	`{ siteKey: string; provider: CaptchaProvider; hideBadge?: boolean \| undefined; recaptchaNet?: boolean \| undefined; enterprise?: boolean \| undefined; endpoints?: string[] \| undefined; }`	-
`baseURL?`	`string`	-
`basePath?`	`string`	`"/auth"`
`avatarSize?`	`number`	`128 \| 256`
`avatarExtension?`	`string`	`"png"`
`avatar?`	`boolean`	`false`
`additionalFields?`	`AdditionalFields`	-
`mutators?`	`Partial<AuthMutators>`	-
`localization?`	`AuthLocalization`	`authLocalization`
`toast?`	`RenderToast`	`Sonner`
`viewPaths?`	`AuthViewPaths`	`authViewPaths`
`hooks?`	`Partial<AuthHooks>`	-
`authClient`	`AuthClient`	`Required`
`children`	`ReactNode`	-

Example

A minimal Next.js layout file using the AuthUIProvider:

"use client"
 
import { AuthUIProvider } from "@daveyplate/better-auth-ui"
import { authClient } from "@/lib/auth-client"
import { useRouter } from "next/navigation"
import Link from "next/link"
 
export default function RootLayout({ children }: { children: React.ReactNode }) {
  const router = useRouter()
 
  return (
    <html lang="en">
      <body>
        <AuthUIProvider
          authClient={authClient}
          navigate={router.push}
          replace={router.replace}
          onSessionChange={() => router.refresh()}
          providers={["github", "google", "facebook", "apple"]}
          multiSession
          magicLink
          passkey
          avatar
          captcha={{
            provider: "google-recaptcha-v3",
            siteKey: "your-site-key",
          }}
          uploadAvatar={(file) => {
            const formData = new FormData()
            formData.append("avatar", file)
 
            const res = await fetch("/api/uploadAvatar", { method: "POST", body: formData })
            const { data } = await res.json()
 
            return data.url
          }}
          settingsURL="/dashboard/settings"
          twoFactor={["otp", "totp"]}
          Link={Link}
        >
          {children}
        </AuthUIProvider>
      </body>
    </html>
  )
}

<AuthUIProvider>

Usage

Reference

Example

On this page