MCPcopy Index your code
hub / github.com/becem-gharbi/nuxt-auth

github.com/becem-gharbi/nuxt-auth @v3.1.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.1.1 ↗ · + Follow
106 symbols 346 edges 57 files 16 documented · 15% ● updated 3mo agov3.1.1 · 2026-03-08★ 90
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Nuxt Auth

npm version npm downloads License Nuxt

A fairly complete solution to handle authentication for your Nuxt project

Features

  • ✔️ Email/password authentication
  • ✔️ Email verification & password reset flows
  • ✔️ Oauth login (Google, Github ...)
  • ✔️ Route middleware protection
  • ✔️ Database agnostic
  • ✔️ Custom backend option
  • ✔️ Auth operations via useAuth composable
  • ✔️ Auto refresh of access token via useAuthFetch composable
  • ✔️ Add dynamic custom claims to access token
  • ✔️ Customizable email templates
  • ✔️ User session management via useAuthSession composable
  • ✔️ Edge deployment on Vercel, Netlify, Cloudflare ...
  • ✔️ Ready to use starter

Installation

Add @bg-dev/nuxt-auth dependency to your project

npx nuxi module add @bg-dev/nuxt-auth

Documentation

The documentation website can be found here.

License

MIT License

Extension points exported contracts — how you extend this code

User (Interface)
(no doc)
src/runtime/types/adapter.d.ts
Session (Interface)
(no doc)
src/runtime/types/adapter.d.ts
Adapter (Interface)
(no doc)
src/runtime/types/adapter.d.ts
MailSendgridProvider (Interface)
(no doc)
src/runtime/types/config.d.ts
MailResendProvider (Interface)
(no doc)
src/runtime/types/config.d.ts

Core symbols most depended-on inside this repo

getConfig
called by 24
src/runtime/server/utils/config.ts
handleError
called by 15
src/runtime/server/utils/error.ts
createCustomError
called by 14
src/runtime/server/utils/error.ts
createUnauthorizedError
called by 14
src/runtime/server/utils/error.ts
warnRequiredOption
called by 13
src/runtime/server/plugins/runtime_options_check.ts
useAuthToken
called by 7
src/runtime/composables/useAuthToken.ts
useAuthSession
called by 6
src/runtime/composables/useAuthSession.ts
goto
called by 5
tests/utils/index.ts

Shape

Function 87
Interface 19

Languages

TypeScript100%

Modules by API surface

src/runtime/composables/useAuth.ts16 symbols
src/runtime/composables/useAuthSession.ts9 symbols
src/runtime/types/common.d.ts8 symbols
src/runtime/server/utils/token/refreshToken.ts8 symbols
src/runtime/server/utils/adapter/unstorage.ts7 symbols
src/runtime/server/utils/adapter/prisma.ts7 symbols
tests/utils/index.ts5 symbols
src/runtime/composables/useAuthToken.ts5 symbols
src/runtime/server/utils/mail.ts4 symbols
src/runtime/server/utils/error.ts4 symbols
src/runtime/types/config.d.ts3 symbols
src/runtime/types/adapter.d.ts3 symbols

For agents

$ claude mcp add nuxt-auth \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page