@nuxt/docs 4.1.3 → 4.2.1

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

@@ -202,7 +202,7 @@ This can be overridden with `definePageMeta` on an individual page. Only JSON-se
 - **Type**: `boolean`
 - **Default:** `false`
 
-**See**: [Vue KeepAlive](https://vuejs.org/api/built-in-components.html#keepalive)
+**See**: [Vue KeepAlive](https://vuejs.org/api/built-in-components#keepalive)
 
 ### `layoutTransition`
 
@@ -213,7 +213,7 @@ This can be overridden with `definePageMeta` on an individual page. Only JSON-se
 - **Type**: `boolean`
 - **Default:** `false`
 
-**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components.html#transition)
+**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
 
 ### `pageTransition`
 
@@ -224,7 +224,7 @@ This can be overridden with `definePageMeta` on an individual page. Only JSON-se
 - **Type**: `boolean`
 - **Default:** `false`
 
-**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components.html#transition)
+**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
 
 ### `rootAttrs`
 
@@ -339,7 +339,7 @@ Shared build configuration.
 
 Nuxt allows visualizing your bundles and how to optimize them.
 
-Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack-contrib/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
 
 - **Type**: `object`
 - **Default**
@@ -424,9 +424,60 @@ A unique identifier matching the build. This may contain the hash of the current
 
 The builder to use for bundling the Vue part of your application.
 
-- **Type**: `string`
+Nuxt supports multiple builders for the client-side application. By default, Vite is used, but you can switch to webpack, Rspack, or even provide a custom builder implementation.
+
+- **Type**: `'vite' | 'webpack' | 'rspack' | string | { bundle: (nuxt: Nuxt) => Promise<void> }`
 - **Default:** `"@nuxt/vite-builder"`
 
+**Using supported builders:**
+
+```ts
+export default defineNuxtConfig({
+  // default - uses @nuxt/vite-builder
+  // builder: 'vite',
+
+  // uses @nuxt/webpack-builder
+  // builder: 'webpack',
+
+  // uses @nuxt/rspack-builder
+  builder: 'rspack',
+})
+```
+
+If you are using `webpack` or `rspack` you will need to make sure `@nuxt/webpack-builder` or `@nuxt/rspack-builder` is explicitly installed in your project.
+
+**Using a custom builder object:**
+
+You can provide a custom builder by passing an object with a `bundle` function:
+
+```ts
+export default defineNuxtConfig({
+  builder: {
+    async bundle (nuxt) {
+      const entry = await resolvePath(resolve(nuxt.options.appDir, 'entry'))
+
+      // Build client and server bundles
+      await buildClient(nuxt, entry)
+      if (nuxt.options.ssr) {
+        await buildServer(nuxt, entry)
+      }
+
+      // ... it's a bit more complicated than that, of course!
+    },
+  },
+})
+```
+
+**Creating a custom builder package:**
+
+To create a custom builder as a separate package, it should export a `bundle` function. You can then specify the package name in your `nuxt.config.ts`:
+
+```ts
+export default defineNuxtConfig({
+  builder: 'my-custom-builder',
+})
+```
+
 ## compatibilityDate
 
 Specify a compatibility date for your app.
@@ -668,7 +719,8 @@ Configure shared esbuild options used within Nuxt and passed to other builders,
 
 ## experimental
 
-::read-more{to="/docs/4.x/guide/going-further/experimental-features"} Learn more about Nuxt's experimental features.
+::read-more{to="/docs/4.x/guide/going-further/experimental-features"}
+Learn more about Nuxt's experimental features.
 ::
 
 ## extends
@@ -701,12 +753,14 @@ The extensions that should be resolved by the Nuxt resolver.
 
 ## features
 
-::read-more{to="/docs/4.x/guide/going-further/features#features"} Learn more about Nuxt's opt-in features.
+::read-more{to="/docs/4.x/guide/going-further/features#features"}
+Learn more about Nuxt's opt-in features.
 ::
 
 ## future
 
-::read-more{to="/docs/4.x/guide/going-further/features#features"} Learn more about opting-in to new features that will become default in a future (possibly major) version of the framework,
+::read-more{to="/docs/4.x/guide/going-further/features#features"}
+Learn more about opting-in to new features that will become default in a future (possibly major) version of the framework.
 ::
 
 ## hooks
@@ -1092,7 +1146,7 @@ and these plugins do not need to be listed in `nuxt.config` unless you
 need to customize their order. All plugins are deduplicated by their src path.
 ::
 
-**See**: [`app/plugins/` directory documentation](https://nuxt.com/docs/4.x/guide/directory-structure/plugins)
+**See**: [`app/plugins/` directory documentation](https://nuxt.com/docs/4.x/guide/directory-structure/app/plugins)
 
 **Example**:
 ```ts
@@ -1163,7 +1217,7 @@ Additional router options passed to `vue-router`. On top of the options for `vue
 For more control, you can use an `router.options.ts` file.
 ::
 
-**See**: [Vue Router documentation](https://router.vuejs.org/api/interfaces/routeroptions.html).
+**See**: [Vue Router documentation](https://router.vuejs.org/api/interfaces/routeroptions)
 
 #### `hashMode`
 
@@ -1218,6 +1272,23 @@ export default defineNuxtConfig({
 })
 ```
 
+## server
+
+Configuration for Nuxt's server builder.
+
+### `builder`
+
+Specify the server builder to use for bundling the server part of your application.
+
+By default, Nuxt uses `@nuxt/nitro-server`, which provides standalone Nitro integration. This architecture allows for different Nitro integration patterns, such as using Nitro as a Vite plugin (with the Vite Environment API).
+
+- **Type**: `string | { bundle: (nuxt: Nuxt) => Promise<void> }`
+- **Default:** `"@nuxt/nitro-server"`
+
+::callout{type="warning"}
+This option is intended for internal use and the API is not finalized. Please open an issue before relying on the current implementation.
+::
+
 ## serverDir
 
 Define the server directory of your Nuxt application, where Nitro routes, middleware and plugins are kept.
@@ -1515,7 +1586,7 @@ export default defineNuxtConfig({
 
 Configuration that will be passed directly to Vite.
 
-**See**: [Vite configuration docs](https://vite.dev/config) for more information.
+**See**: [Vite configuration docs](https://vite.dev/config/) for more information.
 Please note that not all vite options are supported in Nuxt.
 
 ### `build`
@@ -1714,13 +1785,13 @@ Vue.js config
 
 Options for the Vue compiler that will be passed at build time.
 
-**See**: [Vue documentation](https://vuejs.org/api/application.html#app-config-compileroptions)
+**See**: [Vue documentation](https://vuejs.org/api/application#app-config-compileroptions)
 
 ### `config`
 
-It is possible to pass configure the Vue app globally. Only serializable options may be set in your `nuxt.config`. All other options should be set at runtime in a Nuxt plugin..
+It is possible to pass configure the Vue app globally. Only serializable options may be set in your `nuxt.config`. All other options should be set at runtime in a Nuxt plugin.
 
-**See**: [Vue app config documentation](https://vuejs.org/api/application.html#app-config)
+**See**: [Vue app config documentation](https://vuejs.org/api/application#app-config)
 
 ### `propsDestructure`
 
@@ -1847,7 +1918,7 @@ Hard-replaces `typeof process`, `typeof window` and `typeof document` to tree-sh
 
 If you are using webpack, Nuxt uses `webpack-bundle-analyzer` to visualize your bundles and how to optimize them.
 
-Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack-contrib/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
 
 - **Type**: `object`
 - **Default**
@@ -1894,7 +1965,7 @@ Configure [webpack experiments](https://webpack.js.org/configuration/experiments
 
 Enables Common CSS Extraction.
 
-Using [mini-css-extract-plugin](https://github.com/webpack-contrib/mini-css-extract-plugin) under the hood, your CSS will be extracted into separate files, usually one per component. This allows caching your CSS and JavaScript separately.
+Using [mini-css-extract-plugin](https://github.com/webpack/mini-css-extract-plugin) under the hood, your CSS will be extracted into separate files, usually one per component. This allows caching your CSS and JavaScript separately.
 
 - **Type**: `boolean`
 - **Default:** `true`
@@ -1996,7 +2067,7 @@ Set to `false` to disable the overlay provided by [FriendlyErrorsWebpackPlugin](
 
 ### `hotMiddleware`
 
-See [webpack-hot-middleware](https://github.com/webpack-contrib/webpack-hot-middleware) for available options.
+See [webpack-hot-middleware](https://github.com/webpack/webpack-hot-middleware) for available options.
 
 ### `loaders`
 
@@ -2004,7 +2075,7 @@ Customize the options of Nuxt's integrated webpack loaders.
 
 #### `css`
 
-See [css-loader](https://github.com/webpack-contrib/css-loader) for available options.
+See [css-loader](https://github.com/webpack/css-loader) for available options.
 
 ##### `esModule`
 
@@ -2024,7 +2095,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 
 #### `cssModules`
 
-See [css-loader](https://github.com/webpack-contrib/css-loader) for available options.
+See [css-loader](https://github.com/webpack/css-loader) for available options.
 
 ##### `esModule`
 
@@ -2062,11 +2133,11 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 }
 ```
 
-**See**: [esbuild loader](https://github.com/esbuild-kit/esbuild-loader)
+**See**: [esbuild loader](https://github.com/privatenumber/esbuild-loader)
 
 #### `file`
 
-**See**: [`file-loader` Options](https://github.com/webpack-contrib/file-loader#options)
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
 
 **Default**:
 ```json
@@ -2085,7 +2156,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 
 #### `fontUrl`
 
-**See**: [`file-loader` Options](https://github.com/webpack-contrib/file-loader#options)
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
 
 **Default**:
 ```json
@@ -2104,7 +2175,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 
 #### `imgUrl`
 
-**See**: [`file-loader` Options](https://github.com/webpack-contrib/file-loader#options)
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
 
 **Default**:
 ```json
@@ -2130,7 +2201,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 }
 ```
 
-**See**: [`less-loader` Options](https://github.com/webpack-contrib/less-loader#options)
+**See**: [`less-loader` Options](https://github.com/webpack/less-loader#options)
 
 #### `pugPlain`
 
@@ -2138,7 +2209,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 
 #### `sass`
 
-**See**: [`sass-loader` Options](https://github.com/webpack-contrib/sass-loader#options)
+**See**: [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
 
 **Default**:
 ```json
@@ -2165,7 +2236,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 }
 ```
 
-**See**: [`sass-loader` Options](https://github.com/webpack-contrib/sass-loader#options)
+**See**: [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
 
 #### `stylus`
 
@@ -2176,7 +2247,7 @@ See [css-loader](https://github.com/webpack-contrib/css-loader) for available op
 }
 ```
 
-**See**: [`stylus-loader` Options](https://github.com/webpack-contrib/stylus-loader#options)
+**See**: [`stylus-loader` Options](https://github.com/webpack/stylus-loader#options)
 
 #### `vue`
 
@@ -2270,7 +2341,7 @@ Defaults to true when `extractCSS` is enabled.
 - **Type**: `boolean`
 - **Default:** `false`
 
-**See**: [css-minimizer-webpack-plugin documentation](https://github.com/webpack-contrib/css-minimizer-webpack-plugin).
+**See**: [css-minimizer-webpack-plugin documentation](https://github.com/webpack/css-minimizer-webpack-plugin).
 
 ### `plugins`
 
@@ -2297,7 +2368,7 @@ export default defineNuxtConfig({
 
 ### `postcss`
 
-Customize PostCSS Loader. same options as [`postcss-loader` options](https://github.com/webpack-contrib/postcss-loader#options)
+Customize PostCSS Loader. same options as [`postcss-loader` options](https://github.com/webpack/postcss-loader#options)
 
 #### `postcssOptions`
 

package/5.community/3.reporting-bugs.md

@@ -31,15 +31,15 @@ If your issue concerns Vue or Vite, please try to reproduce it first with the Vu
 **Nuxt**:
 
 ::card-group
-  :card{title="Nuxt on StackBlitz" icon="i-simple-icons-stackblitz" to="https://nuxt.new/s/v3" target="_blank"}
-  :card{title="Nuxt on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://nuxt.new/c/v3" target="_blank"}
+  :card{title="Nuxt on StackBlitz" icon="i-simple-icons-stackblitz" to="https://nuxt.new/s/v4" target="_blank"}
+  :card{title="Nuxt on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://nuxt.new/c/v4" target="_blank"}
 ::
 
 **Vue**:
 
 ::card-group
   :card{title="Vue SSR on StackBlitz" icon="i-simple-icons-stackblitz" to="https://stackblitz.com/github/nuxt-contrib/vue3-ssr-starter/tree/main?terminal=dev" target="_blank"}
-  :card{title="Vue SSR on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://codesandbox.io/s/github/nuxt-contrib/vue3-ssr-starter/main" target="_blank"}
+  :card{title="Vue SSR on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://codesandbox.io/p/sandbox/github/nuxt-contrib/vue3-ssr-starter/main" target="_blank"}
   :card{title="Vue SSR Template on GitHub" icon="i-simple-icons-github" to="https://github.com/nuxt-contrib/vue3-ssr-starter/generate" target="_blank"}
 ::
 

package/5.community/4.contribution.md

@@ -143,7 +143,7 @@ Most of the Nuxt ecosystem can consume ESM directly. In general we advocate that
 
 #### What's Corepack
 
-[Corepack](https://nodejs.org/api/corepack.html) makes sure you are using the correct version for package manager when you run corresponding commands. Projects might have `packageManager` field in their `package.json`.
+[Corepack](https://github.com/nodejs/corepack) makes sure you are using the correct version for package manager when you run corresponding commands. Projects might have `packageManager` field in their `package.json`.
 
 Under projects with configuration as shown below, Corepack will install `v7.5.0` of `pnpm` (if you don't have it already) and use it to run your commands.
 

package/5.community/5.framework-contribution.md

@@ -8,19 +8,19 @@ Once you've read the [general contribution guide](/docs/4.x/community/contributi
 
 ## Monorepo Guide
 
-- `packages/kit`: Toolkit for authoring Nuxt Modules, published as [`@nuxt/kit`](https://npmjs.com/package/@nuxt/kit).
-- `packages/nuxt`: The core of Nuxt, published as [`nuxt`](https://npmjs.com/package/nuxt).
-- `packages/schema`: Cross-version Nuxt typedefs and defaults, published as [`@nuxt/schema`](https://npmjs.com/package/@nuxt/schema).
-- `packages/rspack`: The [Rspack](https://rspack.dev) bundler for Nuxt, published as [`@nuxt/rspack-builder`](https://npmjs.com/package/@nuxt/rspack-builder).
-- `packages/vite`: The [Vite](https://vite.dev) bundler for Nuxt, published as [`@nuxt/vite-builder`](https://npmjs.com/package/@nuxt/vite-builder).
-- `packages/webpack`: The [webpack](https://webpack.js.org) bundler for Nuxt, published as [`@nuxt/webpack-builder`](https://npmjs.com/package/@nuxt/webpack-builder).
+- `packages/kit`: Toolkit for authoring Nuxt Modules, published as [`@nuxt/kit`](https://www.npmjs.com/package/@nuxt/kit).
+- `packages/nuxt`: The core of Nuxt, published as [`nuxt`](https://www.npmjs.com/package/nuxt).
+- `packages/schema`: Cross-version Nuxt typedefs and defaults, published as [`@nuxt/schema`](https://www.npmjs.com/package/@nuxt/schema).
+- `packages/rspack`: The [Rspack](https://rspack.rs) bundler for Nuxt, published as [`@nuxt/rspack-builder`](https://www.npmjs.com/package/@nuxt/rspack-builder).
+- `packages/vite`: The [Vite](https://vite.dev) bundler for Nuxt, published as [`@nuxt/vite-builder`](https://www.npmjs.com/package/@nuxt/vite-builder).
+- `packages/webpack`: The [webpack](https://webpack.js.org) bundler for Nuxt, published as [`@nuxt/webpack-builder`](https://www.npmjs.com/package/@nuxt/webpack-builder).
 
 ## Setup
 
 To contribute to Nuxt, you need to set up a local environment.
 
-1. [Fork](https://help.github.com/articles/fork-a-repo) the [`nuxt/nuxt`](https://github.com/nuxt/nuxt)  repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository) it to your local device.
-2. Ensure using the latest [Node.js](https://nodejs.org/en) (20.x)
+1. [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`nuxt/nuxt`](https://github.com/nuxt/nuxt)  repository to your own GitHub account and then [clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) it to your local device.
+2. Ensure using the latest [Node.js](https://nodejs.org/en)
 3. Enable [Corepack](https://github.com/nodejs/corepack) to have `pnpm` and `yarn`
     ```bash [Terminal]
     corepack enable

package/5.community/6.roadmap.md

@@ -32,7 +32,7 @@ Milestone    | Expected date | Notes
 -------------|---------------|------------------------------------------------------------------------|-----------------------
 SEO & PWA    | 2025          | [nuxt/nuxt#18395](https://github.com/nuxt/nuxt/discussions/18395)      | Migrating from [nuxt-community/pwa-module](https://github.com/nuxt-community/pwa-module) for built-in SEO utils and service worker support
 Assets       | 2025          | [nuxt/nuxt#22012](https://github.com/nuxt/nuxt/discussions/22012)      | Allow developers and modules to handle loading third-party assets.
-Translations | -             | [nuxt/translations#4](https://github.com/nuxt/translations/discussions/4) ([request access](https://github.com/nuxt/nuxt/discussions/16054)) | A collaborative project for a stable translation process for Nuxt docs. Currently pending for ideas and documentation tooling support (content v2 with remote sources).
+Translations | -             | [nuxt/nuxt.com#1711](https://github.com/nuxt/nuxt.com/issues/1711)     | A collaborative project for a stable translation process for Nuxt docs. Currently pending for ideas and documentation tooling support.
 
 ## Core Modules Roadmap
 
@@ -68,9 +68,9 @@ Each active version has its own nightly releases which are generated automatical
 Release                    |                                                                                                                                                                               | Initial release       | End Of Life                  | Docs
 -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ---------------------------- | ---------------------------------------
 **5.x** (scheduled)        |                                                                                                                                                                               | Q4 2025 (estimated)   | TBA                          |  
-**4.x** (stable)           | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt latest version" src="https://flat.badgen.net/npm/v/nuxt?label=" class="not-prose"></a>         | 2025-07-16            | 6 months after 5.x release   | [nuxt.com](/docs/4.x)
-**3.x** (maintenance)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 3.x version" src="https://flat.badgen.net/npm/v/nuxt/3x?label=" class="not-prose"></a>         | 2022-11-16            | 2026-01-31                   | [nuxt.com](/docs/3.x)
-**2.x** (unsupported)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 2.x version" src="https://flat.badgen.net/npm/v/nuxt/2x?label=" class="not-prose"></a>         | 2018-09-21            | 2024-06-30                   | [v2.nuxt.com](https://v2.nuxt.com/docs)
+**4.x** (stable)           | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt latest version" src="https://flat.badgen.net/npm/v/nuxt?label=" class="not-prose"></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://flat.badgen.net/npm/v/nuxt/3x?label=" class="not-prose"></a>         | 2022-11-16            | 2026-01-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://flat.badgen.net/npm/v/nuxt/2x?label=" class="not-prose"></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://flat.badgen.net/npm/v/nuxt/1x?label=" class="not-prose"></a>         | 2018-01-08            | 2019-09-21                   | &nbsp;
 
 ### Support Status

package/6.bridge/4.plugins-and-middleware.md

@@ -7,7 +7,7 @@ description: 'Learn how to migrate from Nuxt 2 to Nuxt Bridge new plugins and mi
 
 You can now migrate to the Nuxt 3 plugins API, which is slightly different in format from Nuxt 2.
 
-Plugins now take only one argument (`nuxtApp`). You can find out more in [the docs](/docs/4.x/guide/directory-structure/plugins).
+Plugins now take only one argument (`nuxtApp`). You can find out more in [the docs](/docs/4.x/guide/directory-structure/app/plugins).
 
 ```ts [app/plugins/hello.ts]
 export default defineNuxtPlugin((nuxtApp) => {

package/7.migration/2.configuration.md

@@ -183,7 +183,7 @@ Nuxt can type-check your app using [`vue-tsc`](https://github.com/vuejs/language
 
 There are a number of changes to what is recommended Vue best practice, as well as a number of breaking changes between Vue 2 and 3.
 
-It is recommended to read the [Vue 3 migration guide](https://v3-migration.vuejs.org) and in particular the [breaking changes list](https://v3-migration.vuejs.org/breaking-changes).
+It is recommended to read the [Vue 3 migration guide](https://v3-migration.vuejs.org) and in particular the [breaking changes list](https://v3-migration.vuejs.org/breaking-changes/).
 
 It is not currently possible to use the [Vue 3 migration build](https://v3-migration.vuejs.org/migration-build.html) with Nuxt 3.
 
@@ -227,7 +227,7 @@ export const useMainStore = defineStore('main', {
 })
 ```
 
-Create a [plugin](/docs/4.x/guide/directory-structure/plugins) file to globalize your store:
+Create a [plugin](/docs/4.x/guide/directory-structure/app/plugins) file to globalize your store:
 
 ```ts [app/plugins/pinia.ts]
 import { useMainStore } from '~/store'

package/7.migration/20.module-authors.md

@@ -17,7 +17,7 @@ Explore Nuxt 3 compatible modules.
 
 Nuxt 3 plugins are **not** fully backward compatible with Nuxt 2.
 
-:read-more{to="/docs/4.x/guide/directory-structure/plugins"}
+:read-more{to="/docs/4.x/guide/directory-structure/app/plugins"}
 
 ### Vue Compatibility
 

package/7.migration/5.plugins-and-middleware.md

@@ -31,7 +31,7 @@ export default defineNuxtPlugin((nuxtApp) => {
 
 ::
 
-:read-more{to="/docs/4.x/guide/directory-structure/plugins"}
+:read-more{to="/docs/4.x/guide/directory-structure/app/plugins"}
 
 ::read-more{to="/docs/4.x/api/composables/use-nuxt-app"}
 Read more about the format of `nuxtApp`.

package/7.migration/6.pages-and-layouts.md

@@ -13,13 +13,13 @@ If you don't have an `app.vue` file in your source directory, Nuxt will use its
 
 This file is a great place to put any custom code that needs to be run once when your app starts up, as well as any components that are present on every page of your app. For example, if you only have one layout, you can move this to `app.vue` instead.
 
-:read-more{to="/docs/4.x/guide/directory-structure/app"}
+:read-more{to="/docs/4.x/guide/directory-structure/app/app"}
 
 :link-example{to="/docs/4.x/examples/hello-world"}
 
 ### Migration
 
-Consider creating an `app.vue` file and including any logic that needs to run once at the top-level of your app. You can check out [an example here](/docs/4.x/guide/directory-structure/app).
+Consider creating an `app.vue` file and including any logic that needs to run once at the top-level of your app. You can check out [an example here](/docs/4.x/guide/directory-structure/app/app).
 
 ## Layouts
 

package/README.md

@@ -4,7 +4,7 @@ navigation: false
 
 # Nuxt Docs
 
-This repository contains the documentation of Nuxt hosted on <https://nuxt.com/docs>
+This repository contains the documentation of Nuxt, hosted on <https://nuxt.com/docs/4.x/getting-started/introduction>
 
 ## Contributing
 

package/package.json

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