@nuxt/docs 4.1.2 → 4.2.0

package/6.bridge/7.runtime-config.md

@@ -4,7 +4,7 @@ description: 'Nuxt provides a runtime config API to expose configuration and sec
 ---
 
 ::warning
-When using `runtimeConfig` option, [nitro](/docs/bridge/nitro) must have been configured.
+When using `runtimeConfig` option, [nitro](/docs/4.x/bridge/nitro) must have been configured.
 ::
 
 ## Update Runtime Config

package/6.bridge/8.nitro.md

@@ -14,8 +14,8 @@ import { defineNuxtConfig } from '@nuxt/bridge'
 
 export default defineNuxtConfig({
   bridge: {
-    nitro: true
-  }
+    nitro: true,
+  },
 })
 ```
 
@@ -49,7 +49,7 @@ bun add -D nuxi
 
 ### Nuxi
 
-Nuxt 3 introduced the new Nuxt CLI command [`nuxi`](/docs/api/commands/add). Update your scripts as follows to leverage the better support from Nuxt Bridge:
+Nuxt 3 introduced the new Nuxt CLI command [`nuxi`](/docs/4.x/api/commands/add). Update your scripts as follows to leverage the better support from Nuxt Bridge:
 
 ```diff
 {

package/6.bridge/9.vite.md

@@ -4,7 +4,7 @@ description: 'Activate Vite to your Nuxt 2 application with Nuxt Bridge.'
 ---
 
 ::warning
-When using `vite`, [nitro](/docs/bridge/nitro) must have been configured.
+When using `vite`, [nitro](/docs/4.x/bridge/nitro) must have been configured.
 ::
 
 ## Remove Modules
@@ -19,8 +19,8 @@ import { defineNuxtConfig } from '@nuxt/bridge'
 export default defineNuxtConfig({
   bridge: {
     vite: true,
-    nitro: true
-  }
+    nitro: true,
+  },
 })
 ```
 
@@ -32,6 +32,6 @@ import { defineNuxtConfig } from '@nuxt/bridge'
 export default defineNuxtConfig({
   vite: {
     // Config for Vite
-  }
+  },
 })
 ```

package/7.migration/1.overview.md

@@ -16,9 +16,9 @@ Some of these significant changes include:
 1. Moving from a runtime Nuxt dependency to a minimal, standalone server compiled with nitropack.
 
 ::tip
-If you need to remain on Nuxt 2, but want to benefit from Nuxt 3 features in Nuxt 2, you can alternatively check out [how to get started with Bridge](/docs/bridge/overview).
+If you need to remain on Nuxt 2, but want to benefit from Nuxt 3 features in Nuxt 2, you can alternatively check out [how to get started with Bridge](/docs/4.x/bridge/overview).
 ::
 
 ## Next Steps
 
-- Learn about differences in [configuration](/docs/migration/configuration)
+- Learn about differences in [configuration](/docs/4.x/migration/configuration)

package/7.migration/10.bundling.md

@@ -16,7 +16,7 @@ If you need to configure any of Nuxt's build tools, you can do so in your `nuxt.
 
 In addition, Nuxt ships with TypeScript support.
 
-:read-more{to="/docs/guide/concepts/typescript"}
+:read-more{to="/docs/4.x/guide/concepts/typescript"}
 
 ## Steps
 

package/7.migration/11.server.md

@@ -5,7 +5,7 @@ description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 server.'
 
 In a built Nuxt 3 application, there is no runtime Nuxt dependency. That means your site will be highly performant, and ultra-slim. But it also means you can no longer hook into runtime Nuxt server hooks.
 
-:read-more{to="/docs/guide/concepts/server-engine"}
+:read-more{to="/docs/4.x/guide/concepts/server-engine"}
 
 ## Steps
 
@@ -13,5 +13,5 @@ In a built Nuxt 3 application, there is no runtime Nuxt dependency. That means y
 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/guide/directory-structure/server"}
-:read-more{to="/docs/guide/going-further/hooks#server-hooks-runtime"}
+:read-more{to="/docs/4.x/guide/directory-structure/server"}
+:read-more{to="/docs/4.x/guide/going-further/hooks#server-hooks-runtime"}

package/7.migration/2.configuration.md

@@ -40,8 +40,8 @@ Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/ji
      router: {
        extendRoutes (routes) {
          //
-       }
-     }
+       },
+     },
    }
    ```
 
@@ -50,8 +50,8 @@ Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/ji
      hooks: {
        'pages:extend' (routes) {
          //
-       }
-     }
+       },
+     },
    })
    ```
 
@@ -64,8 +64,8 @@ Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/ji
    ```ts [Nuxt 2]
    export default {
      router: {
-       routeNameSplitter: '/'
-     }
+       routeNameSplitter: '/',
+     },
    }
    ```
 
@@ -78,8 +78,10 @@ Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/ji
          const routeNameSplitter = '/'
          const root = createResolver(import.meta.url).resolve('./pages')
 
-         function updateName(routes) {
-           if (!routes) return
+         function updateName (routes) {
+           if (!routes) {
+             return
+           }
 
            for (const route of routes) {
              const relativePath = route.file.substring(root.length + 1)
@@ -98,7 +100,7 @@ Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/ji
 
 #### ESM Syntax
 
-Nuxt 3 is an [ESM native framework](/docs/guide/concepts/esm). Although [`unjs/jiti`](https://github.com/unjs/jiti) provides semi compatibility when loading `nuxt.config` file, avoid any usage of `require` and `module.exports` in this file.
+Nuxt 3 is an [ESM native framework](/docs/4.x/guide/concepts/esm). Although [`unjs/jiti`](https://github.com/unjs/jiti) provides semi compatibility when loading `nuxt.config` file, avoid any usage of `require` and `module.exports` in this file.
 
 1. Change `module.exports` to `export default`
 1. Change `const lib = require('lib')` to `import lib from 'lib'`
@@ -131,20 +133,20 @@ Nuxt and Nuxt Modules are now build-time-only.
 ```
 
 ::tip
-If you are a module author, you can check out [more information about module compatibility](/docs/migration/module-authors) and [our module author guide](/docs/guide/going-further/modules).
+If you are a module author, you can check out [more information about module compatibility](/docs/4.x/migration/module-authors) and [our module author guide](/docs/4.x/guide/going-further/modules).
 ::
 
 ## Directory Changes
 
 The `static/` (for storing static assets) has been renamed to `public/`. You can either rename your `static` directory to `public`, or keep the name by setting `dir.public` in your `nuxt.config`.
 
-:read-more{to="/docs/guide/directory-structure/public"}
+:read-more{to="/docs/4.x/guide/directory-structure/public"}
 
 ## TypeScript
 
 It will be much easier to migrate your application if you use Nuxt's TypeScript integration. This does not mean you need to write your application in TypeScript, just that Nuxt will provide automatic type hints for your editor.
 
-You can read more about Nuxt's TypeScript support [in the docs](/docs/guide/concepts/typescript).
+You can read more about Nuxt's TypeScript support [in the docs](/docs/4.x/guide/concepts/typescript).
 
 ::note
 Nuxt can type-check your app using [`vue-tsc`](https://github.com/vuejs/language-tools/tree/master/packages/tsc) with `nuxt typecheck` command.
@@ -175,7 +177,7 @@ Nuxt can type-check your app using [`vue-tsc`](https://github.com/vuejs/language
    ```
 
 1. Run `npx nuxt prepare` to generate the tsconfig files.
-1. Install Volar following the instructions in the [docs](/docs/getting-started/introduction#prerequisites).
+1. Install Volar following the instructions in the [docs](/docs/4.x/getting-started/installation#prerequisites).
 
 ## Vue Changes
 
@@ -200,10 +202,10 @@ yarn add pinia @pinia/nuxt
 Enable the module in your nuxt configuration:
 
 ```ts [nuxt.config.ts]
-import { defineNuxtConfig } from 'nuxt/config';
+import { defineNuxtConfig } from 'nuxt/config'
 
 export default defineNuxtConfig({
-  modules: ['@pinia/nuxt']
+  modules: ['@pinia/nuxt'],
 })
 ```
 
@@ -217,7 +219,7 @@ export const useMainStore = defineStore('main', {
     counter: 0,
   }),
   actions: {
-    increment() {
+    increment () {
       // `this` is the store instance
       this.counter++
     },
@@ -225,7 +227,7 @@ export const useMainStore = defineStore('main', {
 })
 ```
 
-Create a [plugin](/docs/guide/directory-structure/plugins) file to globalize your store:
+Create a [plugin](/docs/4.x/guide/directory-structure/plugins) file to globalize your store:
 
 ```ts [app/plugins/pinia.ts]
 import { useMainStore } from '~/store'
@@ -233,8 +235,8 @@ import { useMainStore } from '~/store'
 export default defineNuxtPlugin(({ $pinia }) => {
   return {
     provide: {
-      store: useMainStore($pinia)
-    }
+      store: useMainStore($pinia),
+    },
   }
 })
 ```
@@ -246,8 +248,8 @@ Once it's done you will need to add the following plugin to your Nuxt app:
 ```ts [app/plugins/vuex.ts]
 import store from '~/store'
 
-export default defineNuxtPlugin(nuxtApp => {
-  nuxtApp.vueApp.use(store);
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.use(store)
 })
 ```
 

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

@@ -7,7 +7,7 @@ description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 modules.'
 
 Nuxt 3 has a basic backward compatibility layer for Nuxt 2 modules using `@nuxt/kit` auto wrappers. But there are usually steps to follow to make modules compatible with Nuxt 3 and sometimes, using Nuxt Bridge is required for cross-version compatibility.
 
-We have prepared a [Dedicated Guide](/docs/guide/going-further/modules) for authoring Nuxt 3 ready modules using `@nuxt/kit`. Currently best migration path is to follow it and rewrite your modules. Rest of this guide includes preparation steps if you prefer to avoid a full rewrite yet making modules compatible with Nuxt 3.
+We have prepared a [Dedicated Guide](/docs/4.x/guide/going-further/modules) for authoring Nuxt 3 ready modules using `@nuxt/kit`. Currently best migration path is to follow it and rewrite your modules. Rest of this guide includes preparation steps if you prefer to avoid a full rewrite yet making modules compatible with Nuxt 3.
 
 ::tip{icon="i-lucide-puzzle" to="/modules"}
 Explore Nuxt 3 compatible modules.
@@ -17,7 +17,7 @@ Explore Nuxt 3 compatible modules.
 
 Nuxt 3 plugins are **not** fully backward compatible with Nuxt 2.
 
-:read-more{to="/docs/guide/directory-structure/plugins"}
+:read-more{to="/docs/4.x/guide/directory-structure/plugins"}
 
 ### Vue Compatibility
 
@@ -33,11 +33,11 @@ When Nuxt 3 users add your module, you will not have access to the module contai
 
 Migrating to `@nuxt/bridge` is the first and most important step for supporting Nuxt 3.
 
-If you have a fixture or example in your module, add `@nuxt/bridge` package to its config (see [example](/docs/bridge/overview#update-nuxtconfig))
+If you have a fixture or example in your module, add `@nuxt/bridge` package to its config (see [example](/docs/4.x/bridge/overview#update-nuxtconfig))
 
 ### Migrate from CommonJS to ESM
 
-Nuxt 3 natively supports TypeScript and ECMAScript Modules. Please check [Native ES Modules](/docs/guide/concepts/esm) for more info and upgrading.
+Nuxt 3 natively supports TypeScript and ECMAScript Modules. Please check [Native ES Modules](/docs/4.x/guide/concepts/esm) for more info and upgrading.
 
 ### Ensure Plugins Default Export
 
@@ -69,16 +69,16 @@ export default () => { }
 
 With Nuxt 3, Nuxt is now a build-time-only dependency, which means that modules shouldn't attempt to hook into the Nuxt runtime.
 
-Your module should work even if it's only added to [`buildModules`](/docs/api/nuxt-config#runtimeconfig) (instead of `modules`). For example:
+Your module should work even if it's only added to [`buildModules`](/docs/4.x/api/nuxt-config#runtimeconfig) (instead of `modules`). For example:
 
-- Avoid updating `process.env` within a Nuxt module and reading by a Nuxt plugin; use [`runtimeConfig`](/docs/api/nuxt-config#runtimeconfig) instead.
+- Avoid updating `process.env` within a Nuxt module and reading by a Nuxt plugin; use [`runtimeConfig`](/docs/4.x/api/nuxt-config#runtimeconfig) instead.
 - (*) Avoid depending on runtime hooks like `vue-renderer:*` for production
 - (*) Avoid adding `serverMiddleware` by importing them inside the module. Instead, add them by referencing a file path so that they are independent of the module's context
 
 (*) Unless it is for `nuxt dev` purpose only and guarded with `if (nuxt.options.dev) { }`.
 
 ::tip
-Continue reading about Nuxt 3 modules in the [Modules Author Guide](/docs/guide/going-further/modules).
+Continue reading about Nuxt 3 modules in the [Modules Author Guide](/docs/4.x/guide/going-further/modules).
 ::
 
 ### Use TypeScript (Optional)

package/7.migration/3.auto-imports.md

@@ -4,14 +4,14 @@ description:  Nuxt 3 adopts a minimal friction approach, meaning wherever possib
 ---
 
 ::note
-In the rest of the migration documentation, you will notice that key Nuxt and Vue utilities do not have explicit imports. This is not a typo; Nuxt will automatically import them for you, and you should get full type hinting if you have followed [the instructions](/docs/migration/configuration#typescript) to use Nuxt's TypeScript support.
+In the rest of the migration documentation, you will notice that key Nuxt and Vue utilities do not have explicit imports. This is not a typo; Nuxt will automatically import them for you, and you should get full type hinting if you have followed [the instructions](/docs/4.x/migration/configuration#typescript) to use Nuxt's TypeScript support.
 ::
 
-[Read more about auto imports](/docs/guide/concepts/auto-imports)
+[Read more about auto imports](/docs/4.x/guide/concepts/auto-imports)
 
 ## Migration
 
-1. If you have been using `@nuxt/components` in Nuxt 2, you can remove `components: true` in your `nuxt.config`. If you had a more complex setup, then note that the component options have changed somewhat. See the [components documentation](/docs/guide/directory-structure/app/components) for more information.
+1. If you have been using `@nuxt/components` in Nuxt 2, you can remove `components: true` in your `nuxt.config`. If you had a more complex setup, then note that the component options have changed somewhat. See the [components documentation](/docs/4.x/guide/directory-structure/app/components) for more information.
 
 ::tip
 You can look at `.nuxt/types/components.d.ts` and `.nuxt/types/imports.d.ts` to see how Nuxt has resolved your components and composable auto-imports.

package/7.migration/4.meta.md

@@ -5,8 +5,8 @@ description: Manage your meta tags, from Nuxt 2 to Nuxt 3.
 
 Nuxt 3 provides several different ways to manage your meta tags:
 1. Through your `nuxt.config`.
-2. Through the [`useHead`](/docs/api/composables/use-head) [composable](/docs/getting-started/seo-meta)
-3. Through [global meta components](/docs/getting-started/seo-meta)
+2. Through the [`useHead`](/docs/4.x/api/composables/use-head) [composable](/docs/4.x/getting-started/seo-meta)
+3. Through [global meta components](/docs/4.x/getting-started/seo-meta)
 
 You can customize `title`, `titleTemplate`, `base`, `script`, `noscript`, `style`, `meta`, `link`, `htmlAttrs` and `bodyAttrs`.
 
@@ -14,12 +14,12 @@ You can customize `title`, `titleTemplate`, `base`, `script`, `noscript`, `style
 Nuxt currently uses [`Unhead`](https://github.com/unjs/unhead) to manage your meta tags, but implementation details may change.
 ::
 
-:read-more{to="/docs/getting-started/seo-meta"}
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
 
 ## Migration
 
 1. In your `nuxt.config`, rename `head` to `meta`. Consider moving this shared meta configuration into your `app.vue` instead. (Note that objects no longer have a `hid` key for deduplication.)
-2. If you need to access the component state with `head`, you should migrate to using [`useHead`](/docs/api/composables/use-head) . You might also consider using the built-in meta-components.
+2. If you need to access the component state with `head`, you should migrate to using [`useHead`](/docs/4.x/api/composables/use-head) . You might also consider using the built-in meta-components.
 3. If you need to use the Options API, there is a `head()` method you can use when you use `defineNuxtComponent`.
 
 ### useHead
@@ -31,18 +31,18 @@ Nuxt currently uses [`Unhead`](https://github.com/unjs/unhead) to manage your me
 export default {
   data: () => ({
     title: 'My App',
-    description: 'My App Description'
-  })
+    description: 'My App Description',
+  }),
   head () {
     return {
       title: this.title,
       meta: [{
         hid: 'description',
         name: 'description',
-        content: this.description
-      }]
+        content: this.description,
+      }],
     }
-  }
+  },
 }
 </script>
 ```
@@ -57,8 +57,8 @@ useHead({
   title,
   meta: [{
     name: 'description',
-    content: description
-  }]
+    content: description,
+  }],
 })
 </script>
 ```
@@ -80,10 +80,10 @@ export default {
       meta: [{
         hid: 'description',
         name: 'description',
-        content: 'My App Description'
-      }]
+        content: 'My App Description',
+      }],
     }
-  }
+  },
 }
 </script>
 ```
@@ -93,7 +93,10 @@ export default {
   <div>
     <Head>
       <Title>My App</Title>
-      <Meta name="description" content="My app description"/>
+      <Meta
+        name="description"
+        content="My app description"
+      />
     </Head>
     <!-- -->
   </div>
@@ -118,10 +121,10 @@ export default defineNuxtComponent({
     return {
       meta: [{
         name: 'description',
-        content: 'This is my page description.'
-      }]
+        content: 'This is my page description.',
+      }],
     }
-  }
+  },
 })
 </script>
 ```

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

@@ -9,31 +9,31 @@ Plugins now have a different format, and take only one argument (`nuxtApp`).
 
 ::code-group
 
-```js [Nuxt 2]
+```ts [Nuxt 2]
 export default (ctx, inject) => {
   inject('injected', () => 'my injected function')
-})
+}
 ```
 
 ```ts [Nuxt 3]
-export default defineNuxtPlugin(nuxtApp => {
+export default defineNuxtPlugin((nuxtApp) => {
   // now available on `nuxtApp.$injected`
   nuxtApp.provide('injected', () => 'my injected function')
 
   // You can alternatively use this format, which comes with automatic type support
   return {
     provide: {
-      injected: () => 'my injected function'
-    }
+      injected: () => 'my injected function',
+    },
   }
 })
 ```
 
 ::
 
-:read-more{to="/docs/guide/directory-structure/plugins"}
+:read-more{to="/docs/4.x/guide/directory-structure/plugins"}
 
-::read-more{to="/docs/api/composables/use-nuxt-app"}
+::read-more{to="/docs/4.x/api/composables/use-nuxt-app"}
 Read more about the format of `nuxtApp`.
 ::
 
@@ -72,7 +72,7 @@ Much like Nuxt 2, route middleware placed in your `~/middleware` folder is autom
 
 `navigateTo` is one of a number of route helper functions.
 
-:read-more{to="/docs/guide/directory-structure/app/middleware"}
+:read-more{to="/docs/4.x/guide/directory-structure/app/middleware"}
 
 ### Migration
 

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

@@ -13,19 +13,19 @@ 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/guide/directory-structure/app"}
+:read-more{to="/docs/4.x/guide/directory-structure/app"}
 
-:link-example{to="/docs/examples/hello-world"}
+: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/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).
 
 ## Layouts
 
 If you are using layouts in your app for multiple pages, there is only a slight change required.
 
-In Nuxt 2, the `<Nuxt>` component is used within a layout to render the current page. In Nuxt 3, layouts use slots instead, so you will have to replace that component with a `<slot />`. This also allows advanced use cases with named and scoped slots. [Read more about layouts](/docs/guide/directory-structure/app/layouts).
+In Nuxt 2, the `<Nuxt>` component is used within a layout to render the current page. In Nuxt 3, layouts use slots instead, so you will have to replace that component with a `<slot />`. This also allows advanced use cases with named and scoped slots. [Read more about layouts](/docs/4.x/guide/directory-structure/app/layouts).
 
 You will also need to change how you define the layout used by a page using the `definePageMeta` compiler macro. Layouts will be kebab-cased. So `app/layouts/customLayout.vue` becomes `custom-layout` when referenced in your page.
 
@@ -42,7 +42,7 @@ You will also need to change how you define the layout used by a page using the
         </div>
       </template>
     ```
-2. Use [`definePageMeta`](/docs/api/utils/define-page-meta) to select the layout used by your page.
+2. Use [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) to select the layout used by your page.
     ```diff [app/pages/index.vue]
     + <script setup>
     + definePageMeta({
@@ -54,7 +54,7 @@ You will also need to change how you define the layout used by a page using the
     - }
       </script>
     ```
-3. Move `~/layouts/_error.vue` to `~/error.vue`. See [the error handling docs](/docs/getting-started/error-handling). If you want to ensure that this page uses a layout, you can use [`<NuxtLayout>`](/docs/guide/directory-structure/app/layouts) directly within `error.vue`:
+3. Move `~/layouts/_error.vue` to `~/error.vue`. See [the error handling docs](/docs/4.x/getting-started/error-handling). If you want to ensure that this page uses a layout, you can use [`<NuxtLayout>`](/docs/4.x/guide/directory-structure/app/layouts) directly within `error.vue`:
     ```vue [error.vue]
     <template>
       <div>
@@ -67,7 +67,7 @@ You will also need to change how you define the layout used by a page using the
 
 ## Pages
 
-Nuxt 3 ships with an optional `vue-router` integration triggered by the existence of a [`app/pages/`](/docs/guide/directory-structure/app/pages) directory in your source directory. If you only have a single page, you may consider instead moving it to `app.vue` for a lighter build.
+Nuxt 3 ships with an optional `vue-router` integration triggered by the existence of a [`app/pages/`](/docs/4.x/guide/directory-structure/app/pages) directory in your source directory. If you only have a single page, you may consider instead moving it to `app.vue` for a lighter build.
 
 ### Dynamic Routes
 
@@ -84,19 +84,19 @@ In Nuxt 2, you will have defined any nested routes (with parent and child compon
 
 If you were passing a custom page key or keep-alive props to `<Nuxt>`, you will now use `definePageMeta` to set these options.
 
-:read-more{to="/docs/guide/directory-structure/app/pages#special-metadata"}
+:read-more{to="/docs/4.x/guide/directory-structure/app/pages#special-metadata"}
 
 ### Page and Layout Transitions
 
 If you have been defining transitions for your page or layout directly in your component options, you will now need to use `definePageMeta` to set the transition. Since Vue 3, [-enter and -leave CSS classes have been renamed](https://v3-migration.vuejs.org/breaking-changes/transition.html). The `style` prop from `<Nuxt>` no longer applies to transition when used on `<slot>`, so move the styles to your `-active` class.
 
-:read-more{to="/docs/getting-started/transitions"}
+:read-more{to="/docs/4.x/getting-started/transitions"}
 
 ### Migration
 
 1. Rename any pages with dynamic parameters to match the new format.
 2. Update `<Nuxt>` and `<NuxtChild>` to be `<NuxtPage>`.
-3. If you're using the Composition API, you can also migrate `this.$route` and `this.$router` to use [`useRoute`](/docs/api/composables/use-route) and [`useRouter`](/docs/api/composables/use-router)  composables.
+3. If you're using the Composition API, you can also migrate `this.$route` and `this.$router` to use [`useRoute`](/docs/4.x/api/composables/use-route) and [`useRouter`](/docs/4.x/api/composables/use-router)  composables.
 
 #### Example: Dynamic Routes
 
@@ -145,13 +145,17 @@ If you have been defining transitions for your page or layout directly in your c
 ```vue [Nuxt 2]
 <template>
   <div>
-    <NuxtChild keep-alive :keep-alive-props="{ exclude: ['modal'] }" :nuxt-child-key="$route.slug" />
+    <NuxtChild
+      keep-alive
+      :keep-alive-props="{ exclude: ['modal'] }"
+      :nuxt-child-key="$route.slug"
+    />
   </div>
 </template>
 
 <script>
 export default {
-  transition: 'page' // or { name: 'page' }
+  transition: 'page', // or { name: 'page' }
 }
 </script>
 ```
@@ -172,7 +176,7 @@ definePageMeta({
     name: 'page',
   },
   keepalive: {
-    exclude: ['modal']
+    exclude: ['modal'],
   },
 })
 </script>
@@ -182,18 +186,18 @@ definePageMeta({
 
 ## `<NuxtLink>` Component
 
-Most of the syntax and functionality are the same for the global [NuxtLink](/docs/api/components/nuxt-link) component. If you have been using the shortcut `<NLink>` format, you should update this to use `<NuxtLink>`.
+Most of the syntax and functionality are the same for the global [NuxtLink](/docs/4.x/api/components/nuxt-link) component. If you have been using the shortcut `<NLink>` format, you should update this to use `<NuxtLink>`.
 
 `<NuxtLink>` is now a drop-in replacement for _all_ links, even external ones. You can read more about it, and how to extend it to provide your own link component.
 
-:read-more{to="/docs/api/components/nuxt-link"}
+:read-more{to="/docs/4.x/api/components/nuxt-link"}
 
 ## Programmatic Navigation
 
 When migrating from Nuxt 2 to Nuxt 3, you will have to update how you programmatically navigate your users. In Nuxt 2, you had access to the underlying Vue Router with `this.$router`. In Nuxt 3, you can use the `navigateTo()` utility method which allows you to pass a route and parameters to Vue Router.
 
 ::warning
-Make sure to always `await` on [`navigateTo`](/docs/api/utils/navigate-to) or chain its result by returning from functions.
+Make sure to always `await` on [`navigateTo`](/docs/4.x/api/utils/navigate-to) or chain its result by returning from functions.
 ::
 
 ::code-group
@@ -202,29 +206,29 @@ Make sure to always `await` on [`navigateTo`](/docs/api/utils/navigate-to) or ch
 <script>
 export default {
   methods: {
-    navigate(){
+    navigate () {
       this.$router.push({
         path: '/search',
         query: {
           name: 'first name',
-          type: '1'
-        }
+          type: '1',
+        },
       })
-    }
-  }
+    },
+  },
 }
 </script>
 ```
 
 ```vue [Nuxt 3]
 <script setup lang="ts">
-function navigate(){
+function navigate () {
   return navigateTo({
     path: '/search',
     query: {
       name: 'first name',
-      type: '1'
-    }
+      type: '1',
+    },
   })
 }
 </script>