nuxt-better-auth について
NuxtとBetter Authの連携開発向けスキルです。クライアント・サーバー認証、ルート保護、プラグイン、データベースを作業別に案内し、セッション管理にも触れます。
主な機能
- 01作業に応じたリファレンス選択
- 02クライアントセッションと認証UI
- 03サーバー側のセッション管理
- 04ページとAPIルートの保護
- 05プラグインとデータベース設定
活用シーン
- 01Better Authモジュールの導入
- 02セッションの読み取りや更新
- 03ページとAPIルートの保護
- 04外部Better Authサーバーへの接続
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ onmax/ nuxt-skills --skill nuxt-better-authインストール後、Claude Code で/nuxt-better-authを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/client-auth.mdclient-only.mddatabase.mdinstallation.mdplugins.mdroute-protection.mdserver-auth.mdtypes.md詳細
Nuxt Better Auth
タスクに合った、最小限のリファレンスを参照してください。
リファレンスを選ぶ
| タスク | 参照先 |
|---|---|
| モジュールをインストールする、環境変数を設定する、または設定ファイルを作成する | references/installation.md |
| クライアントのセッション状態を読み取る、認証フォームを作成する、プラグインを呼び出す、または認証に関連付けられたデータを取得する | references/client-auth.md |
| サーバーハンドラーでセッションを読み取る、または強制する、セッションを作成する、またはキャッシュされたセッションデータを更新する | references/server-auth.md |
| ページまたは API ルートを保護し、リダイレクトを設定する | references/route-protection.md |
| Better Auth プラグインとそのクライアント側の連携機能を登録する | references/plugins.md |
| NuxtHub、生成されたスキーマ、またはセカンダリストレージを設定する | references/database.md |
| Nuxt フロントエンドを外部の Better Auth サーバーに接続する | references/client-only.md |
| 推論された認証型を使用する、またはプロジェクトのフィールドを追加する | references/types.md |
タスク全般に適用されるルール
- 使用する各 API が、利用者のインストール済みパッケージバージョンに対応していることを確認してください。公開済みのスキルが、利用者のロックファイルに記載されたバージョンより新しい場合があります。
- 保護対象の API に対する読み取りと変更は、
requireUserSession(event)を使ってサーバー側で強制してください。ルートルールとページメタデータもナビゲーションを制御します。 - 検証済みのローカルリダイレクトパスにのみ移動してください。
clientOnlyモードでは、ローカルのサーバーヘルパーを使用せず、SSR によるセッションのハイドレーションも想定しないでください。- セッションペイロードのフィールドをサーバー側で変更した後は、
refreshSessionCookieCache(event)を呼び出してください。現在のセッションを作成または変更するカスタムクライアント認証エンドポイントは、runWithSessionRefresh()でラップしてください。
実装を完了する前に、利用者の型チェックと、関連する認証テストのうち最も対象範囲の狭いものを実行してください。
リソース
コメント
Markdown 対応