@nuxt/docs 4.3.0 → 4.4.2

package/4.api/5.kit/11.nitro.md

@@ -301,6 +301,10 @@ function addPrerenderRoutes (routes: string | string[]): void
 
 Add imports to the server. It makes your imports available in Nitro without the need to import them manually.
 
+::warning
+If you want to provide a utility that works in both server and client contexts and is usable in the [`shared/`](/docs/4.x/directory-structure/shared) directory, the function must be imported from the same source file for both [`addImports`](/docs/4.x/api/kit/autoimports#addimports) and `addServerImports` and should have identical signature. That source file should not import anything context-specific (i.e., Nitro context, Nuxt app context) or else it might cause errors during type-checking.
+::
+
 ### Usage
 
 ```ts twoslash
@@ -422,10 +426,10 @@ export default defineEventHandler(() => {
 ## `addServerScanDir`
 
 Add directories to be scanned by Nitro. It will check for subdirectories, which will be registered
-just like the `~/server` folder is.
+just like the `~~/server` folder is.
 
 ::note
-Only `~/server/api`, `~/server/routes`, `~/server/middleware`, and `~/server/utils` are scanned.
+Only `~~/server/api`, `~~/server/routes`, `~~/server/middleware`, and `~~/server/utils` are scanned.
 ::
 
 ### Usage

package/4.api/5.kit/4.autoimports.md

@@ -24,7 +24,11 @@ Watch Vue School video about Auto-imports Nuxt Kit utilities.
 
 ## `addImports`
 
-Add imports to the Nuxt application. It makes your imports available in the Nuxt application without the need to import them manually.
+Add imports to the Nuxt application. It makes your imports available in the Nuxt app context without the need to import them manually.
+
+::tip
+To add imports for the Nitro server context, refer to the [`addServerImports`](/docs/4.x/api/kit/nitro#addserverimports) function.
+::
 
 ### Usage
 

package/4.api/6.advanced/1.hooks.md

@@ -30,7 +30,7 @@ Check the [app source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt
 | `page:loading:end`           | -                   | Client          | Called after `page:finish`                                                                                                                                                            |
 | `page:transition:finish`     | `pageComponent?`    | Client          | After page transition [onAfterLeave](https://vuejs.org/guide/built-ins/transition#javascript-hooks) event.                                                                            |
 | `dev:ssr-logs`               | `logs`              | Client          | Called with an array of server-side logs that have been passed to the client (if `features.devLogs` is enabled).                                                                      |
-| `page:view-transition:start` | `transition`        | Client          | Called after `document.startViewTransition` is called when [experimental viewTransition support is enabled](/docs/4.x/getting-started/transitions#view-transitions-api-experimental). |
+| `page:view-transition:start` | `transition`        | Client          | Called after `document.startViewTransition` is called when [experimental viewTransition support is enabled](/docs/4.x/getting-started/transitions#view-transitions-api-experimental). The `transition` argument is a [`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition) object with a `types` property ([`ViewTransitionTypeSet`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransitionTypeSet)) that can be read or modified. |
 
 ## Nuxt Hooks (build time)
 

package/4.api/6.nuxt-config.md

@@ -13,12 +13,13 @@ You can improve your DX by defining additional aliases to access custom director
 - **Default**
 ```json
 {
-  "~": "/<srcDir>",
-  "@": "/<srcDir>",
+  "~": "/<rootDir>/app",
+  "@": "/<rootDir>/app",
   "~~": "/<rootDir>",
   "@@": "/<rootDir>",
   "#shared": "/<rootDir>/shared",
-  "assets": "/<srcDir>/assets",
+  "#server": "/<rootDir>/server",
+  "assets": "/<rootDir>/app/assets",
   "public": "/<rootDir>/public",
   "#build": "/<rootDir>/.nuxt",
   "#internal/nuxt/paths": "/<rootDir>/.nuxt/paths.mjs"
@@ -372,7 +373,7 @@ export default defineNuxtConfig({
   build: {
     templates: [
       {
-        src: '~/modules/support/plugin.js', // `src` can be absolute or relative
+        src: '~~/modules/support/plugin.js', // `src` can be absolute or relative
         dst: 'support.js', // `dst` is relative to project `.nuxt` dir
       },
     ],
@@ -880,7 +881,7 @@ Defaults to 'silent' when running in CI or when a TTY is not available. This opt
 Modules are Nuxt extensions which can extend its core functionality and add endless integrations.
 
 Each module is either a string (which can refer to a package, or be a path to a file), a tuple with the module as first string and the options as a second object, or an inline module function.
-Nuxt tries to resolve each item in the modules array using node require path (in `node_modules`) and then will be resolved from project `srcDir` if `~` alias is used.
+Nuxt tries to resolve each item in the modules array using node require path (in `node_modules`) and then will be resolved from project `rootDir` if `~~` alias is used.
 
 - **Type**: `array`
 
@@ -895,8 +896,8 @@ export default defineNuxtConfig({
   modules: [
   // Using package name
     '@nuxt/scripts',
-    // Relative to your project srcDir
-    '~/custom-modules/awesome.js',
+    // Relative to your project rootDir
+    '~~/custom-modules/awesome.js',
     // Providing options
     ['@nuxtjs/google-analytics', { ua: 'X1234567' }],
     // Inline definition
@@ -1013,8 +1014,12 @@ Options passed directly to the transformer from `unctx` that preserves async con
 
 Functions to inject a key for.
 
-As long as the number of arguments passed to the function is less than `argumentLength`, an additional magic string will be injected that can be used to deduplicate requests between server and client. You will need to take steps to handle this additional key.
-The key will be unique based on the location of the function being invoked within the file.
+As long as the number of arguments passed to the function is less than `argumentLength`, an additional magic string will be injected as the last argument. This key is stable between SSR and client-side hydration. You will need to take steps to handle this additional key.
+The key is unique based on the location of the function being invoked within the file.
+
+::read-more{to="/docs/4.x/guide/modules/recipes-basics#add-keyed-functions"}
+Learn more about keyed functions.
+::
 
 - **Type**: `array`
 - **Default**
@@ -1022,31 +1027,38 @@ The key will be unique based on the location of the function being invoked withi
 [
   {
     "name": "callOnce",
-    "argumentLength": 3
+    "argumentLength": 3,
+    "source": "#app/composables/once"
   },
   {
     "name": "defineNuxtComponent",
-    "argumentLength": 2
+    "argumentLength": 2,
+    "source": "#app/composables/component"
   },
   {
     "name": "useState",
-    "argumentLength": 2
+    "argumentLength": 2,
+    "source": "#app/composables/state"
   },
   {
     "name": "useFetch",
-    "argumentLength": 3
+    "argumentLength": 3,
+    "source": "#app/composables/fetch"
   },
   {
     "name": "useAsyncData",
-    "argumentLength": 3
+    "argumentLength": 3,
+    "source": "#app/composables/asyncData"
   },
   {
     "name": "useLazyAsyncData",
-    "argumentLength": 3
+    "argumentLength": 3,
+    "source": "#app/composables/asyncData"
   },
   {
     "name": "useLazyFetch",
-    "argumentLength": 3
+    "argumentLength": 3,
+    "source": "#app/composables/fetch"
   }
 ]
 ```
@@ -1297,7 +1309,7 @@ Define the server directory of your Nuxt application, where Nitro routes, middle
 If a relative path is specified, it will be relative to your `rootDir`.
 
 - **Type**: `string`
-- **Default:** `"/<srcDir>/server"`
+- **Default:** `"/<rootDir>/server"`
 
 ## serverHandlers
 
@@ -1318,7 +1330,7 @@ Each handler accepts the following options:
 ```ts
 export default defineNuxtConfig({
   serverHandlers: [
-    { route: '/path/foo/**:name', handler: '~/server/foohandler.ts' },
+    { route: '/path/foo/**:name', handler: '#server/foohandler.ts' },
   ],
 })
 ```
@@ -1408,22 +1420,27 @@ export default defineNuxtConfig({
   srcDir: 'app/',
 })
 ```
+
 This expects the following folder structure:
 ```bash
 -| app/
 ---| assets/
 ---| components/
+---| composables/
 ---| layouts/
 ---| middleware/
 ---| pages/
 ---| plugins/
+---| utils/
 ---| app.config.ts
 ---| app.vue
 ---| error.vue
 -| server/
+-| shared/
 -| public/
 -| modules/
--| nuxt.config.js
+-| layers/
+-| nuxt.config.ts
 -| package.json
 ```
 
@@ -1692,7 +1709,7 @@ Please note that not all vite options are supported in Nuxt.
 ### `root`
 
 - **Type**: `string`
-- **Default:** `"/<srcDir>"`
+- **Default:** `"/<rootDir>"`
 
 ### `server`
 
@@ -1705,7 +1722,7 @@ Please note that not all vite options are supported in Nuxt.
 ```json
 [
   "/<rootDir>/.nuxt",
-  "/<srcDir>",
+  "/<rootDir>/app",
   "/<rootDir>",
   "/<workspaceDir>"
 ]

package/5.community/2.getting-help.md

@@ -41,7 +41,7 @@ We recommend taking a look at [how to report bugs](/docs/4.x/community/reporting
 
 ## "I need professional help"
 
-If the community couldn't provide the help you need in the time-frame you have, NuxtLabs offers professional support with the [Nuxt Experts](https://nuxt.com/enterprise/support).
+If the community couldn't provide the help you need in the time-frame you have, NuxtLabs offers professional support with the [Nuxt Experts](https://nuxt.com/enterprise/agencies).
 
 The objective of the Nuxt Expert is to provide support to the Vue ecosystem, while also creating freelance opportunities for those contributing to open-source solutions, thus helping to maintain the sustainability of the ecosystem.
 

package/5.community/6.roadmap.md

@@ -61,15 +61,15 @@ We commit to support each major version of Nuxt for a minimum of six months afte
 
 The current active version of [Nuxt](https://nuxt.com) is **v4** which is available as `nuxt` on npm with the `latest` tag.
 
-Nuxt 3 will continue to receive maintenance updates (both bug fixes and backports of features from Nuxt 4) until the end of January 2026.
+Nuxt 3 will continue to receive maintenance updates (bug fixes and security patches) until the end of July 2026.
 
 Each active version has its own nightly releases which are generated automatically. For more about enabling the Nuxt nightly release channel, see [the nightly release channel docs](/docs/4.x/guide/going-further/nightly-release-channel).
 
 | Release               |                                                                                                                                                                                                                                                    | Initial release     | End Of Life                | Docs                                                              |
 |-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|----------------------------|-------------------------------------------------------------------|
-| **5.x** (scheduled)   |                                                                                                                                                                                                                                                    | Q4 2025 (estimated) | TBA                        |                                                              |
+| **5.x** (scheduled)   |                                                                                                                                                                                                                                                    | Q1 2026 (estimated) | TBA                        |                                                              |
 | **4.x** (stable)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt latest version" src="https://img.shields.io/npm/v/nuxt.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2025-07-16          | 6 months after 5.x release | [nuxt.com](/docs/4.x/getting-started/introduction)                |
-| **3.x** (maintenance) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 3.x version" src="https://img.shields.io/npm/v/nuxt/3x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2022-11-16          | 2026-01-31                 | [nuxt.com](/docs/3.x/getting-started/introduction)                |
+| **3.x** (maintenance) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 3.x version" src="https://img.shields.io/npm/v/nuxt/3x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2022-11-16          | 2026-07-31                 | [nuxt.com](/docs/3.x/getting-started/introduction)                |
 | **2.x** (unsupported) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 2.x version" src="https://img.shields.io/npm/v/nuxt/2x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2018-09-21          | 2024-06-30                 | [v2.nuxt.com](https://v2.nuxt.com/docs/get-started/installation/) |
 | **1.x** (unsupported) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 1.x version" src="https://img.shields.io/npm/v/nuxt/1x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2018-01-08          | 2019-09-21                 | &nbsp;                                                            |
 

package/7.migration/11.server.md

@@ -10,7 +10,7 @@ In a built Nuxt 3 application, there is no runtime Nuxt dependency. That means y
 ## Steps
 
 1. Remove the `render` key in your `nuxt.config`.
-2. Any files in `~/server/api` and `~/server/middleware` will be automatically registered; you can remove them from your `serverMiddleware` array.
+2. Any files in `~~/server/api` and `~~/server/middleware` will be automatically registered; you can remove them from your `serverMiddleware` array.
 3. Update any other items in your `serverMiddleware` array to point to files or npm packages directly, rather than using inline functions.
 
 :read-more{to="/docs/4.x/directory-structure/server"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/docs",
-  "version": "4.3.0",
+  "version": "4.4.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",