Nuxt Better Auth

Alpha Status: This module is currently in alpha (v0.0.2-alpha.19) and not recommended for production use. APIs may change.

When to Use

• Installing/configuring

  @onmax/nuxt-better-auth

• Implementing login/signup/signout flows
• Protecting routes (client and server)
• Accessing user session in API routes
• Integrating Better Auth plugins (admin, passkey, 2FA)
• Setting up database with NuxtHub
• Using clientOnly mode for external auth backends
• Adding i18n support with

  @nuxtjs/i18n

nuxt

nuxthub

Available Guidance

Loading Files

• references/installation.md - if installing or configuring the module
• references/client-auth.md - if building login/signup/signout flows
• references/server-auth.md - if protecting API routes or accessing user session server-side
• references/route-protection.md - if using routeRules or definePageMeta for auth
• references/plugins.md - if integrating Better Auth plugins (admin, passkey, 2FA)
• references/database.md - if setting up database with NuxtHub or Drizzle
• references/client-only.md - if using external auth backend with clientOnly mode
• references/types.md - if working with AuthUser, AuthSession, or type augmentation

Key Concepts

useUserSession()

requireUserSession()

auth

'user'

'guest'

{ user: {...} }

false

serverAuth()

Quick Reference

// Client: useUserSession()
const { user, loggedIn, signIn, signOut } = useUserSession()
await signIn.email({ email, password }, { onSuccess: () => navigateTo('/') })

// Server: requireUserSession()
const { user } = await requireUserSession(event, { user: { role: 'admin' } })

// nuxt.config.ts: Route protection
routeRules: {
  '/admin/**': { auth: { user: { role: 'admin' } } },
  '/login': { auth: 'guest' },
  '/app/**': { auth: 'user' }
}

Resources

• Module Docs
• Better Auth Docs