version: "1.0.1" name: nuxt-auth-utils description: Use when implementing auth in Nuxt apps with nuxt-auth-utils - provides useUserSession composable, OAuth handlers, cookie-based sessions, and route protection. Works on all deployment targets without DB dependency.

Nuxt Auth Utils

Cookie-based authentication module for Nuxt. No database required for session storage — sessions are encrypted and stored in cookies.

When to Use

• Installing/configuring nuxt-auth-utils
• Implementing OAuth login flows (Google, GitHub, etc.)
• Protecting routes (client and server)
• Accessing user session in API routes
• Setting up session types

For Nuxt patterns: use nuxt skill For better-auth (DB-based auth): use nuxt-better-auth skill

Available Guidance

Loading Files

• [ ] references/client-auth.md - if building login/logout flows
• [ ] references/server-auth.md - if protecting API routes or setting up OAuth handlers

DO NOT load all files at once. Load only what's relevant to your current task.

Key Concepts

Quick Reference

// Client: useUserSession()
const { user, loggedIn, clear } = useUserSession()

// Server: OAuth handler
export default defineOAuthGoogleEventHandler({
  async onSuccess(event, { user: googleUser }) {
    await setUserSession(event, {
      user: { id: googleUser.sub, email: googleUser.email, name: googleUser.name },
    })
    return sendRedirect(event, '/')
  },
})

// Server: protect API route
const { user } = await requireUserSession(event)

vs better-auth

Resources

• nuxt-auth-utils Docs

_Token efficiency: Main skill ~300 tokens, each sub-file ~600-800 tokens_