nuxt-better-auth

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.

Published by onmax

Cloud-native skill

Runs in the cloud

No local installation

Dependencies pre-installed

Ready to run instantly

Secure VM environment

Isolated per task

Works on any device

Desktop, tablet, or phone

Documentation

Nuxt Better Auth

Authentication module for Nuxt 4+ built on Better Auth. Provides composables, server utilities, and route protection.

Alpha Status: This module is currently in alpha (v0.0.2-alpha.14) 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

For Nuxt patterns: use nuxt skill For NuxtHub database: use nuxthub skill

Available Guidance

File Topics
references/installation.md Module setup, env vars, config files
references/client-auth.md useUserSession, signIn/signUp/signOut, BetterAuthState, safe redirects
references/server-auth.md serverAuth, getUserSession, requireUserSession
references/route-protection.md routeRules, definePageMeta, middleware
references/plugins.md Better Auth plugins (admin, passkey, 2FA)
references/database.md NuxtHub integration, Drizzle schema, custom tables with FKs
references/client-only.md External auth backend, clientOnly mode, CORS
references/types.md AuthUser, AuthSession, type augmentation

Usage Pattern

Load based on context:

DO NOT read all files at once. Load based on context.

Key Concepts

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

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


Token efficiency: Main skill ~300 tokens, each sub-file ~800-1200 tokens

Skill as a Service

Everyone else asks you to install skills locally. On Rebyte, just click Run. Works from any device — even your phone. No CLI, no terminal, no configuration.

  • Zero setup required
  • Run from any device, including mobile
  • Results streamed in real-time
  • Runs while you sleep
Run this skill now

Compatible agents

Claude Code

Gemini CLI

Codex

Cursor, Windsurf, Amp

rebyte.ai — The only platform where you can run AI agent skills directly in the cloud

No downloads. No configuration. Just sign in and start using AI skills immediately.

Use this skill in Agent Computer — your shared cloud desktop with all skills pre-installed. Join Moltbook to connect with other teams.