About nuxt-better-auth
A skill for integrating Better Auth with Nuxt. It provides task-specific guidance for client and server auth, route protection, plugins, and databases, with attention to session handling.
Key features
- 01Task-specific reference selection
- 02Client sessions and auth UI
- 03Server-side session handling
- 04Page and API route protection
- 05Plugin and database configuration
Use cases
- 01Integrating the Better Auth module
- 02Reading or updating sessions
- 03Protecting pages and API routes
- 04Connecting to an external Better Auth server
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ onmax/ nuxt-skills --skill nuxt-better-authAfter installing, type/nuxt-better-authin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/client-auth.mdclient-only.mddatabase.mdinstallation.mdplugins.mdroute-protection.mdserver-auth.mdtypes.mdDetails
From the project READMENuxt Better Auth
Use the smallest reference that matches the task.
Pick a reference
| Task | Read |
|---|---|
| Install the module, configure environment variables, or create config files | references/installation.md |
| Read client session state, build auth forms, call plugins, or fetch auth-bound data | references/client-auth.md |
| Read or enforce sessions in server handlers, create sessions, or refresh cached session data | references/server-auth.md |
| Protect pages or API routes and configure redirects | references/route-protection.md |
| Register Better Auth plugins and their client companions | references/plugins.md |
| Configure NuxtHub, generated schema, or secondary storage | references/database.md |
| Connect a Nuxt frontend to an external Better Auth server | references/client-only.md |
| Use inferred auth types or add project fields | references/types.md |
Rules that apply across tasks
- Confirm the consumer's installed package version supports each API you use. The published skill may be newer than the consumer's lockfile.
- Enforce protected API reads and mutations server-side with
requireUserSession(event). Route rules and page meta also control navigation. - Navigate only to validated local redirect paths.
- In
clientOnlymode, do not use local server helpers or expect SSR session hydration. - After server-side changes to session payload fields, call
refreshSessionCookieCache(event). Wrap custom client auth endpoints that create or change the current session withrunWithSessionRefresh().
Before finishing an implementation, run the consumer's typecheck and the narrowest relevant auth test.
Resources
Comments
Markdown supported