// Use when implementing auth in Nuxt apps with @onmax/nuxt-better-auth - provides useUserSession composable, server auth helpers, route protection, and Better Auth plugins integration.
| name | nuxt-better-auth |
| description | Use when implementing auth in Nuxt apps with @onmax/nuxt-better-auth - provides useUserSession composable, server auth helpers, route protection, and Better Auth plugins integration. |
| license | MIT |
Authentication module for Nuxt 4+ built on Better Auth. It adds Nuxt-specific setup, route protection, server helpers, and typed auth state.
Alpha status: the package is still pre-stable. Verify behavior against the current docs and source before relying on edge cases.
@onmax/nuxt-better-auth| File | Topics |
|---|---|
| references/installation.md | install flow, env vars, config files |
| references/client-auth.md | useUserSession, client methods, redirects, loading states |
| references/server-auth.md | serverAuth, getUserSession, getRequestSession, requireUserSession |
| references/route-protection.md | route rules, page meta, API protection |
| references/plugins.md | plugin pairing between server and client |
| references/database.md | NuxtHub schema generation, secondary storage |
| references/client-only.md | external Better Auth backends and clientOnly mode |
| references/types.md | public auth types and augmentation |
Do not load every reference file by default. Pick the smallest file that matches the task.
| Concept | Description |
|---|---|
useUserSession() | Client composable - user, session, loggedIn, signIn/Out methods |
requireUserSession() | Server helper - throws 401/403 if not authenticated |
auth route mode | 'user', 'guest', { user: {...} }, or false |
serverAuth() | Get Better Auth instance in server routes |
// 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' }
}