nuxt-better-auth

The nuxt-better-auth skill is guidance for implementing authentication in Nuxt 4+ applications using the @onmax/nuxt-better-auth module, which is built on top of Better Auth. It solves the problem of wiring up sessions, login/signup/signout flows, and route protection in Nuxt without hand-rolling auth plumbing, providing a useUserSession composable on the client and server helpers such as serverAuth, getUserSession, and requireUserSession. The skill is upfront that the module is in alpha (v0.0.2-alpha.19) and not recommended for production, with APIs subject to change.

Structured as a routing surface with a table of reference files, it covers installation and configuration (module setup, env vars, config files), client auth flows, server-side session access, route protection via routeRules and definePageMeta, Better Auth plugin integration (admin, passkey, two-factor), NuxtHub database setup with Drizzle schemas, clientOnly mode for external auth backends with CORS, and TypeScript type augmentation. It instructs loading only the reference relevant to the current task rather than all files. Credential handling follows standard practice: a BETTER_AUTH_SECRET of at least 32 characters supplied via environment variable or runtimeConfig, and OAuth client IDs/secrets pulled from runtime config.

Target users are Nuxt developers adding authentication to their apps, including those needing OAuth social providers, passkeys, 2FA, or an external auth backend. Use cases span building login and signup flows, protecting pages and API routes, accessing the user session in server routes, and setting up a session database on NuxtHub.