@nuxt/docs 4.2.0 → 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**
@@ -1146,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
@@ -1217,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`
 
@@ -1586,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`
@@ -1785,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`
 
@@ -1918,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**
@@ -1965,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`
@@ -2067,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`
 
@@ -2075,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`
 
@@ -2095,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`
 
@@ -2133,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
@@ -2156,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
@@ -2175,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
@@ -2201,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`
 
@@ -2209,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
@@ -2236,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`
 
@@ -2247,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`
 
@@ -2341,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`
 
@@ -2368,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

@@ -39,7 +39,7 @@ If your issue concerns Vue or Vite, please try to reproduce it first with the Vu
 
 ::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

@@ -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.2.0",
+  "version": "4.2.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",