Nuxt Better Auth

Better Auth 上に構築された Nuxt 4+ 用の認証モジュール。composables、サーバーユーティリティ、ルート保護を提供します。

アルファ状態: このモジュールは現在アルファ版 (v0.0.2-alpha.19) であり、本番環境での使用は推奨されません。API は変更される可能性があります。

使用対象

• @onmax/nuxt-better-auth のインストール/設定
• ログイン/サインアップ/サインアウトフローの実装
• ルートの保護（クライアントおよびサーバー）
• API ルートでのユーザーセッションへのアクセス
• Better Auth プラグイン (admin、passkey、2FA) の統合
• NuxtHub でのデータベース設定
• 外部認証バックエンド用の clientOnly モードの使用
• @nuxtjs/i18n による i18n サポートの追加

Nuxt パターン用: nuxt スキルを使用 NuxtHub データベース用: nuxthub スキルを使用

利用可能なガイダンス

ファイル	トピック
references/installation.md	モジュール設定、環境変数、設定ファイル
references/client-auth.md	useUserSession、signIn/signUp/signOut、BetterAuthState、安全なリダイレクト
references/server-auth.md	serverAuth、getUserSession、requireUserSession
references/route-protection.md	routeRules、definePageMeta、middleware
references/plugins.md	Better Auth プラグイン (admin、passkey、2FA)
references/database.md	NuxtHub 統合、Drizzle スキーマ、FK 付きカスタムテーブル
references/client-only.md	外部認証バックエンド、clientOnly モード、CORS
references/types.md	AuthUser、AuthSession、型の拡張

ファイルの読み込み

タスクに基づいて、これらのリファレンスファイルの読み込みを検討してください:

• references/installation.md - モジュールをインストールまたは設定する場合
• references/client-auth.md - ログイン/サインアップ/サインアウトフローを構築する場合
• references/server-auth.md - API ルートを保護するか、サーバー側でユーザーセッションにアクセスする場合
• references/route-protection.md - 認証用に routeRules または definePageMeta を使用する場合
• references/plugins.md - Better Auth プラグイン (admin、passkey、2FA) を統合する場合
• references/database.md - NuxtHub または Drizzle でデータベースを設定する場合
• references/client-only.md - clientOnly モードで外部認証バックエンドを使用する場合
• references/types.md - AuthUser、AuthSession、または型の拡張を使用する場合

すべてのファイルを一度に読み込まないでください。 現在のタスクに関連するものだけを読み込んでください。

主要概念

概念	説明
useUserSession()	クライアント composable - user、session、loggedIn、signIn/Out メソッド
requireUserSession()	サーバーヘルパー - 認証されていない場合は 401/403 をスロー
auth ルートモード	'user'、'guest'、{ user: {...} }、または false
serverAuth()	サーバールートで Better Auth インスタンスを取得

クイックリファレンス

// クライアント: useUserSession()
const { user, loggedIn, signIn, signOut } = useUserSession()
await signIn.email({ email, password }, { onSuccess: () => navigateTo('/') })

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

// nuxt.config.ts: ルート保護
routeRules: {
  '/admin/**': { auth: { user: { role: 'admin' } } },
  '/login': { auth: 'guest' },
  '/app/**': { auth: 'user' }
}

リソース

• Module Docs
• Better Auth Docs

---

トークン効率: メインスキル ~300 トークン、各サブファイル ~800-1200 トークン