All skills
onmax avatar

/nuxt-better-auth

@de09c7b official
by Maxonmax/nuxt-skills715 stars
38

Guides authentication in Nuxt apps using @nuxtjs/better-auth. Use when installing or configuring the module, using its client or server APIs, protecting routes, refreshing sessions, or integrating Better Auth plugins.

Use this Skill: https://skilld.dev/gh/onmax/nuxt-skills/nuxt-better-auth

This session only. Nothing lands on disk.

referencesdatabase.md

≈326 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Database integration

Fastest database-backed path

Use NuxtHub.

export default defineNuxtConfig({
  modules: ['@nuxthub/core', '@nuxtjs/better-auth'],
  hub: {
    db: 'sqlite',
  },
})

What the module does with NuxtHub

  • reads server/auth.config.ts
  • generates auth tables from enabled Better Auth features
  • exposes generated schema through #auth/schema
  • supports custom atomic secondary storage for session lookup caching

Secondary storage

export default defineNuxtConfig({
  hub: { db: 'sqlite' },
  auth: {
    hubSecondaryStorage: 'custom',
  },
})

Important:

  • NuxtHub KV cannot implement Better Auth 1.7's atomic getAndDelete and increment operations, so hubSecondaryStorage: true logs a setup warning and continues without module-provided secondary storage. Sessions use the configured database when one exists. Track native support in nuxt-hub/core#927
  • hubSecondaryStorage: 'custom' means you provide an atomic secondaryStorage, such as Redis or Upstash
  • use DB-only reads if you prefer stricter read-after-write consistency

Non-NuxtHub setups

If you are not using NuxtHub, configure the Better Auth adapter yourself in server/auth.config.ts and manage schema generation separately.

Source: SKILL.md on GitHub

No alerts8d4 checks · Risk SAFE
  • Gen Agent Trust Hub8d

    This skill provides comprehensive documentation and guidance for integrating the @nuxtjs/better-auth module into Nuxt.js applications. It covers installation, client and server-side API usage, database integration with NuxtHub, and route protection strategies. The skill follows security best practices, such as recommending environment variables for secret management and local path validation for redirects. No malicious patterns or security risks were identified.

  • Socket8d

    No alerts

  • Snyk8d

    Risk: LOW · No issues

  • Runlayer7mo

    1/9 files flagged

Signed by skilld at de09c7b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated last week
  • Nuxt
  • TypeScript
  • better-auth
  • authentication
  • composables
  • route-protection
  • server-auth
  • nuxthub

README badge

README badge for onmax/nuxt-skills/nuxt-better-auth

Nuxt authentication module built on Better Auth, providing useUserSession composable, server route protection, and plugin integration for login/signup flows. Currently alpha status. Targets Nuxt 4+ apps implementing session-based auth with support for Better Auth plugins like passkey and 2FA.

Generated from the current SKILL.md.

Is this production-ready?
No. The module is in alpha (v0.0.2-alpha.19) and APIs may change. Not recommended for production use.
What versions of Nuxt does this support?
Nuxt 4 and later.
Can I use this with an external auth backend?
Yes, via clientOnly mode. This allows you to connect to auth providers outside Nuxt with CORS handling.
Does this support multi-factor authentication and passkeys?
Yes, through Better Auth plugins for 2FA, passkey, and admin functionality.
How do I protect API routes and pages?
Use `requireUserSession()` on the server side for API routes, and `routeRules` or `definePageMeta` with the `auth` property for page protection.

Generated from the current SKILL.md. These answers refresh after source changes.