sidebase · mridang · Jul 28, 2025 · Jul 28, 2025 · Jul 28, 2025 · Jul 28, 2025
diff --git a/README.md b/README.md
@@ -28,7 +28,7 @@
 </p>
 <!-- Badges End -->
 
-> Authentication built for Nuxt 3! Easily add authentication via OAuth providers, credentials or Email Magic URLs!
+> Authentication built for Nuxt 4! Easily add authentication via OAuth providers, credentials or Email Magic URLs!
 
 ## Quick Start
 
@@ -62,8 +62,8 @@ Then visit the [Quick Start documentation](https://auth.sidebase.io/guide/gettin
 
 ## Features
 
-`@sidebase/nuxt-auth` is a library with the goal of supporting authentication for any universal Nuxt 3 application. At the moment three providers are supported:
-- [`authjs`](https://auth.sidebase.io/guide/authjs/quick-start): for non-static apps that want to use [Auth.js / NextAuth.js](https://github.com/nextauthjs/next-auth) to offer the reliability & convenience of a 23k star library to the Nuxt 3 ecosystem with a native developer experience (DX)
+`@sidebase/nuxt-auth` is a library with the goal of supporting authentication for any universal Nuxt 4 application. At the moment three providers are supported:
+- [`authjs`](https://auth.sidebase.io/guide/authjs/quick-start): for non-static apps that want to use [Auth.js / NextAuth.js](https://github.com/nextauthjs/next-auth) to offer the reliability & convenience of a 23k star library to the Nuxt 4 ecosystem with a native developer experience (DX)
 - [`local`](https://auth.sidebase.io/guide/local/quick-start): for static pages that rely on an external backend with a credential flow for authentication. The Local Provider also supports refresh tokens since `v0.9.0`. Read more [here](https://auth.sidebase.io/upgrade/version-0.9.0).
 
 You can find a full list of our features, as well as which provider supports each feature [on our docs](https://auth.sidebase.io/guide/getting-started/choose-provider).
@@ -142,9 +142,9 @@ We have one playground per provider:
 - [`authjs`](./playground-authjs)
 - [`local`](./playground-local)
 
-##### How to test static Nuxt 3 apps?
+##### How to test static Nuxt 4 apps?
 
-To test static Nuxt 3 apps we want to run a static frontend and a separate backend that will take over authentication:
+To test static Nuxt 4 apps we want to run a static frontend and a separate backend that will take over authentication:
 1. `playground-local/nuxt.config.ts`: Add `baseURL: 'http://localhost:3001'` to the `auth`-config
 2. Start the static frontend:
     ```sh
@@ -154,7 +154,7 @@ To test static Nuxt 3 apps we want to run a static frontend and a separate backe
 
     pnpm start
     ```
-3. Start the authentication backend (we use a second instance of the same nuxt3 app):
+3. Start the authentication backend (we use a second instance of the same Nuxt 4 app):
     ```sh
     cd playground-local
 
@@ -171,7 +171,7 @@ Thank you to everyone who has contributed to this project by writing issues or o
 
 ## Acknowledgments
 
-`@sidebase/nuxt-auth` is supported by all of our amazing contributors and the [Nuxt 3 team](https://nuxters.nuxt.com/)!
+`@sidebase/nuxt-auth` is supported by all of our amazing contributors and the [Nuxt 4 team](https://nuxters.nuxt.com/)!
 
 <a href="https://github.com/sidebase/nuxt-auth/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=sidebase/nuxt-auth" />

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -6,7 +6,7 @@ import { headConfig, sitemapConfig } from './head'
 export default defineConfig({
   title: 'NuxtAuth',
   titleTemplate: ':title - by sidebase',
-  description: 'Authentication for Nuxt 3',
+  description: 'Authentication for Nuxt 4',
   base: '/',
   cleanUrls: true,
   lang: 'en-US',

diff --git a/docs/.vitepress/head.ts b/docs/.vitepress/head.ts
@@ -10,7 +10,7 @@ export const sitemapConfig = {
 export const headConfig: HeadConfig[] = [
   ['link', { rel: 'icon', href: '/favicon.ico' }],
   ['meta', { name: 'theme-color', content: '#30A36C' }],
-  ['meta', { property: 'og:title', content: 'NuxtAuth | Authentication for Nuxt 3' }],
+  ['meta', { property: 'og:title', content: 'NuxtAuth | Authentication for Nuxt 4' }],
   ['meta', { property: 'og:description', content: 'User authentication and sessions via authjs' }],
   ['meta', { property: 'og:site_name', content: 'NuxtAuth' }],
   ['meta', { property: 'og:type', content: 'website' }],

diff --git a/docs/guide/advanced/deployment/self-hosted.md b/docs/guide/advanced/deployment/self-hosted.md
@@ -1,6 +1,6 @@
 # Self Hosting
 
-This guide will explain how you can self-host a Nuxt3 application running NuxtAuth.
+This guide will explain how you can self-host a Nuxt 4 application running NuxtAuth.
 
 ## Authjs Provider
 

diff --git a/docs/guide/application-side/protecting-pages.md b/docs/guide/application-side/protecting-pages.md
@@ -123,7 +123,7 @@ definePageMeta({
 You may create your own application-side middleware in order to implement custom, more advanced authentication logic.
 
 :::warning
-Creating a custom middleware is an advanced, experimental option and may result in unexpected or undesired behavior if you are not familiar with advanced Nuxt 3 concepts.
+Creating a custom middleware is an advanced, experimental option and may result in unexpected or undesired behavior if you are not familiar with advanced Nuxt 4 concepts.
 :::
 
 To implement your custom middleware:

diff --git a/docs/guide/authjs/server-side/session-access.md b/docs/guide/authjs/server-side/session-access.md
@@ -13,7 +13,7 @@ export default eventHandler(async (event) => {
 This is inspired by [the `getServerSession`](https://next-auth.js.org/tutorials/securing-pages-and-api-routes#securing-api-routes) of NextAuth.js. It also avoids an external HTTP `GET` request to the `/api/auth/sessions` endpoint, instead directly calling a pure JS-method.
 
 :::warning Note:
-If you use [Nuxt's `useFetch`](https://nuxt.com/docs/api/composables/use-fetch) from your app-components to fetch data from an endpoint that uses `getServerSession` or `getToken` you will need to manually pass along cookies as [Nuxt 3 universal rendering](https://nuxt.com/docs/guide/concepts/rendering#universal-rendering) will not do this per-default when it runs on the server-side. Not passing along cookies will result in `getServerSession` returning `null` when it is called from the server-side as no auth cookies will exist. Here's an example that manually passes along cookies:
+If you use [Nuxt's `useFetch`](https://nuxt.com/docs/api/composables/use-fetch) from your app-components to fetch data from an endpoint that uses `getServerSession` or `getToken` you will need to manually pass along cookies as [Nuxt 4 universal rendering](https://nuxt.com/docs/guide/concepts/rendering#universal-rendering) will not do this per-default when it runs on the server-side. Not passing along cookies will result in `getServerSession` returning `null` when it is called from the server-side as no auth cookies will exist. Here's an example that manually passes along cookies:
 ```ts
 const headers = useRequestHeaders(['cookie']) as HeadersInit
 const { data: token } = await useFetch('/api/token', { headers })

diff --git a/docs/guide/getting-started/introduction.md b/docs/guide/getting-started/introduction.md
@@ -1,6 +1,6 @@
 # Introduction
 
-NuxtAuth is an open source Nuxt module that provides authentication for Nuxt 3 applications. It supports multiple authentication methods, allowing you to customize the ways users login to your application.
+NuxtAuth is an open source Nuxt module that provides authentication for Nuxt 4 applications. It supports multiple authentication methods, allowing you to customize the ways users login to your application.
 
 Through a direct integration into Nuxt, you can access and utlize the user sessions within your pages, components and composables directly.
 
@@ -28,9 +28,9 @@ Through a direct integration into Nuxt, you can access and utlize the user sessi
 
 ### Why does NuxtAuth require NextAuth?
 
-The `authjs` provider is able to provide all of its features by wrapping [Auth.js / NextAuth.js](https://github.com/nextauthjs/next-auth) under the hood. This gives the reliability & convenience of a >22.000 github star library to the Nuxt 3 ecosystem with a native nuxt developer experience (DX). Wrapping Auth.js / NextAuth.js has the second advantage that many OAuth providers, database adapters, callbacks and more are supported out-of-the-box. This also means that you can use all NextAuth.js and Auth.js guides and documentation to achieve things with the authjs provider of nuxt-auth.
+The `authjs` provider is able to provide all of its features by wrapping [Auth.js / NextAuth.js](https://github.com/nextauthjs/next-auth) under the hood. This gives the reliability & convenience of a >22.000 github star library to the Nuxt 4 ecosystem with a native nuxt developer experience (DX). Wrapping Auth.js / NextAuth.js has the second advantage that many OAuth providers, database adapters, callbacks and more are supported out-of-the-box. This also means that you can use all NextAuth.js and Auth.js guides and documentation to achieve things with the authjs provider of nuxt-auth.
 
-NuxtAuth also provides Nuxt 3 specific features like a convenient application-side composable to login, logout, access user-authentication data or an authentication middleware and plugin that take care of managing the user authentication lifecycle by fetching authentication data on initial load, refreshing the user authentication on re-focusing the tab and more.
+NuxtAuth also provides Nuxt 4 specific features like a convenient application-side composable to login, logout, access user-authentication data or an authentication middleware and plugin that take care of managing the user authentication lifecycle by fetching authentication data on initial load, refreshing the user authentication on re-focusing the tab and more.
 
 ### What is the difference between Auth.js and NextAuth?
 

diff --git a/docs/index.md b/docs/index.md
@@ -5,7 +5,7 @@ title: Auth
 
 hero:
   name: NuxtAuth
-  text: Authentication for Nuxt 3!
+  text: Authentication for Nuxt 4!
   tagline: User authentication and sessions via authjs!
   actions:
     - theme: brand
@@ -22,7 +22,7 @@ features:
   - icon:
         src: /icons/Github.png
     title: OAuth
-    details: Effortlessly connect your Nuxt 3 application with Google, Github, Azure and countless others.
+    details: Effortlessly connect your Nuxt 4 application with Google, Github, Azure and countless others.
   - icon:
         src: /icons/Database.png
     title: Use your own backend

diff --git a/docs/recipes/introduction/welcome.md b/docs/recipes/introduction/welcome.md
@@ -1,6 +1,6 @@
 # Recipes
 
-The following pages contain recipes for commonly asked patterns, questions, and implementations. The recipes are mostly provided by the community and can serve as guidelines to implement something similar in your Nuxt 3 application.
+The following pages contain recipes for commonly asked patterns, questions, and implementations. The recipes are mostly provided by the community and can serve as guidelines to implement something similar in your Nuxt 4 application.
 
 ## What are recipes?
 

diff --git a/docs/resources/overview.md b/docs/resources/overview.md
@@ -15,7 +15,7 @@ There are some terms we use in this documentation that may not be known to every
 
 ## Module Concept
 
-The idea of this library is to re-use all the open-source implementation that already exist in the JS ecosystem instead of rolling our own. The idea was born when researching through the ecosystem of framework-specific authentication libraries to figure out what the best implementation approach for a state-of-the-art Nuxt 3 authentication library would be.
+The idea of this library is to re-use all the open-source implementation that already exist in the JS ecosystem instead of rolling our own. The idea was born when researching through the ecosystem of framework-specific authentication libraries to figure out what the best implementation approach for a state-of-the-art Nuxt 4 authentication library would be.
 
 During research it became clear that implementing everything from scratch will be:
 - a lot of work that has already been open-sourced by others,
@@ -30,6 +30,6 @@ In our investigation we found prior attempts to make NextAuth.js framework agnos
 - [NextAuth.js app examples](https://github.com/nextauthjs/next-auth/tree/main/apps)
 - [Various comments, proposals, ...or this thread](https://github.com/nextauthjs/next-auth/discussions/3942), special thanks to [brillout](https://github.com/brillout) for starting the discussion, [balazsorban44](https://github.com/balazsorban44) for NextAuth.js and encouraging the discussion, [wobsoriano](https://github.com/wobsoriano) for adding PoCs for multiple languages
 
-The main part of the work was to piece everything together, resolve some outstanding issues with existing PoCs, add new things where nothing existed yet, e.g., for the `useAuth` composable by going through the NextAuth.js client code and translating it to a Nuxt 3 approach.
+The main part of the work was to piece everything together, resolve some outstanding issues with existing PoCs, add new things where nothing existed yet, e.g., for the `useAuth` composable by going through the NextAuth.js client code and translating it to a Nuxt 4 approach.
 
 The module had another big iteration in collaboration with [JoaoPedroAS51](https://github.com/JoaoPedroAS51) to make `useAuth` a sync operation and trigger the session lifecycle from a plugin rather than the `useAuth` composable itself.
diff --git a/package.json b/package.json
@@ -3,7 +3,7 @@
   "version": "1.0.1",
   "license": "MIT",
   "type": "module",
-  "description": "Authentication built for Nuxt 3! Easily add authentication via OAuth providers, credentials or Email Magic URLs!",
+  "description": "Authentication built for Nuxt 4! Easily add authentication via OAuth providers, credentials or Email Magic URLs!",
   "homepage": "https://auth.sidebase.io",
   "repository": "github:sidebase/nuxt-auth",
   "engines": {
@@ -12,13 +12,10 @@
   },
   "exports": {
     ".": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/module.mjs",
-      "require": "./dist/module.cjs"
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
     }
   },
-  "main": "./dist/module.cjs",
-  "types": "./dist/types.d.ts",
   "files": [
     "dist"
   ],
@@ -36,33 +33,32 @@
     "test:unit": "vitest"
   },
   "dependencies": {
-    "@nuxt/kit": "^3.17.6",
+    "@nuxt/kit": "^4.0.0",
     "defu": "^6.1.4",
     "h3": "^1.15.3",
-    "knitwork": "^1.2.0",
-    "nitropack": "^2.11.13",
     "requrl": "^3.0.2",
-    "scule": "^1.3.0",
     "ufo": "^1.6.1"
   },
   "peerDependencies": {
     "next-auth": "~4.21.1"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^4.16.2",
-    "@nuxt/module-builder": "^0.8.4",
-    "@nuxt/schema": "^3.17.6",
-    "@nuxtjs/eslint-config-typescript": "^12.1.0",
+    "@antfu/eslint-config": "^5.0.0",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "^4.0.0",
+    "@nuxt/eslint": "^1.7.1",
     "@types/node": "^20.19.6",
     "eslint": "^9.30.1",
-    "nuxt": "^3.17.6",
+    "nuxt": "^4.0.0",
     "ofetch": "^1.4.1",
-    "oxlint": "^0.16.12",
-    "ts-essentials": "^9.4.2",
+    "oxlint": "^1.0.0",
+    "ts-essentials": "^10.1.1",
     "typescript": "^5.8.3",
     "vitepress": "^1.6.3",
     "vitest": "^3.2.4",
-    "vue-tsc": "^2.2.12"
+    "vue-tsc": "^2.0.21",
+	"vite": "^7.0.0",
+	"nitropack": "^2.11.13"
   },
   "packageManager": "pnpm@9.6.0+sha512.38dc6fba8dba35b39340b9700112c2fe1e12f10b17134715a4aa98ccf7bb035e76fd981cf0bb384dfa98f8d6af5481c2bef2f4266a24bfa20c34eb7147ce0b5e"
 }
diff --git a/playground-authjs/package.json b/playground-authjs/package.json
@@ -9,7 +9,7 @@
     "postinstall": "nuxt prepare"
   },
   "devDependencies": {
-    "nuxt": "^3.17.6",
+    "nuxt": "^4.0.0",
     "typescript": "^5.8.3",
     "vue-tsc": "^2.2.12"
   }

diff --git a/playground-local/package.json b/playground-local/package.json
@@ -21,7 +21,7 @@
     "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "^20.19.6",
     "@vue/test-utils": "^2.4.6",
-    "nuxt": "^3.17.6",
+    "nuxt": "^4.0.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "vue-tsc": "^2.2.12"