Getting Started

Introduction

Nuxt Better Auth integrates Better Auth with Nuxt for route protection, session management, and schema generation.

Nuxt Better Auth integrates Nuxt and Better Auth, the TypeScript-first authentication library. You get route protection, session management, and schema generation without configuration. The plugin ecosystem adds features like 2FA, organizations, and passkeys.

Live Demo – Try the authentication flow in action.

Features

This module brings Nuxt-specific enhancements on top of Better Auth:

Auto Configuration

Zero-config setup with sensible defaults

Route Protection

Declarative page and API route guards

Schema Generation

Auto-generate Drizzle schemas

Reactive Sessions

useUserSession() with SSR support

Database Flexibility

Works standalone or with NuxtHub

Type Safety

Full TypeScript inference

Auto Imports

Composables and utils ready to use

Server Utilities

Auth helpers for your API routes

2FA, OAuth, SSO, organizations, and more

Why Nuxt Better Auth?

Building authentication from scratch is hard. Wiring up Better Auth with Nuxt manually involves:

Setting up API handlers
Syncing client/server state
Handling redirects
Managing database schemas (if using a database)

This module does all of that for you. It's designed to be drop-in and zero-config where possible.

Quick Start

Get a working login in 5 minutes with NuxtHub (SQLite).

Install

pnpm add @onmax/nuxt-better-auth better-auth @nuxthub/core

npm install @onmax/nuxt-better-auth better-auth @nuxthub/core

Configure

nuxt.config.ts

export default defineNuxtConfig({
  modules: ['@nuxthub/core', '@onmax/nuxt-better-auth'],
  hub: { db: 'sqlite' },
})

.env

NUXT_BETTER_AUTH_SECRET="generate-a-32-char-secret"

Create Config Files

server/auth.config.ts

import { defineServerAuth } from '@onmax/nuxt-better-auth'

export default defineServerAuth(() => ({
  emailAndPassword: { enabled: true },
}))

app/auth.config.ts

import { createAuthClient } from 'better-auth/vue'

export function createAppAuthClient(baseURL: string) {
  return createAuthClient({ baseURL })
}

Run

pnpm dev

npm run dev

You now have API routes at /api/auth/*, a reactive useUserSession() composable, and route protection via definePageMeta.

Continue to Installation for detailed setup options.