diff --git a/docs/0.index.md b/docs/0.index.md
index 923a6060e0..babd05db97 100644
--- a/docs/0.index.md
+++ b/docs/0.index.md
@@ -1,216 +1,151 @@
---
title: Documentation
navigation: false
+layout: home
description: Learn everything you need to know about Nuxt, from beginner to master.
+hero:
+ title: The Intuitive Web Framework
+ description: Discover the leading the web framework for building modern Vue applications.
+ cta:
+ - Get Started
+ - /getting-started/installation
+ secondary:
+ - Star on GitHub
+ - https://github.com/nuxt/nuxt
+ snippet: npx nuxi@latest init nuxt-app
---
-
-
-::docs-hero
-#title
-Nuxt Docs
-#description
+# Introduction
+
Nuxt is a free and [open-source framework](https://github.com/nuxt/nuxt) with an intuitive and extendable way to create type-safe, performant and production-grade full-stack web applications and websites with [Vue.js](https://vuejs.org).
+
+We made everything so you can start writing `.vue` files from the beginning while enjoying hot module replacement in development and a performant application in production with server-side rendering by default.
+
+Nuxt has no vendor lock-in, allowing you to deploy your application [**anywhere, even to the edge**](/docs/getting-started/deployment).
+
+## Automation and Conventions
+
+Nuxt uses conventions and an opinionated directory structure to automate repetitive tasks and allow developers to focus on pushing features. The configuration file can still customize and override its default behaviors.
+
+::list{type=success}
+- **File-based routing:** define routes based on the structure of your [`pages/` directory](/docs/guide/directory-structure/pages). This can make it easier to organize your application and avoid the need for manual route configuration.
+- **Code splitting:** Nuxt automatically splits your code into smaller chunks, which can help reduce the initial load time of your application.
+- **Server-side rendering out of the box:** Nuxt comes with built-in SSR capabilities, so you don't have to set up a separate server yourself.
+- **Auto-imports:** write Vue composables and components in their respectives directories and use them without having to import them with the benefits of tree-shaking and optimised JS bundles.
+- **Data-fetching utilities:** Nuxt provides composables to handle SSR-compatible data fetching as well as different strategies.
+- **Zero-config TypeScript support:** write type-safe code without having to learn TypeScript with our auto-generated types and `tsconfig.json`
+- **Configured build tools:** we use [Vite](https://vitejs.dev) by default to support hot module replacement (HMR) in development and bundling your code for production with best-practices baked-in.
::
-::card-item{ .mt-4 }
+Nuxt takes care of these and provides both frontend and backend functionality so you can focus on what matters: **creating your web application**.
+
+## Server-Side Rendering
+
+Nuxt comes with built-in server-side rendering (SSR) capabilities by default, without having to configure a server yourself, which has many benefits for web applications:
+
+::list{type=success}
+- **Faster initial page load time:** Nuxt sends a fully rendered HTML page to the browser, which can be displayed immediately. This can provide a faster perceived page load time and a better user experience (UX), especially on slower networks or devices.
+- **Improved SEO:** search engines can better index SSR pages because the HTML content is available immediately, rather than requiring JavaScript to render the content on the client-side.
+- **Better performance on low-powered devices:** it reduces the amount of JavaScript that needs to be downloaded and executed on the client-side, which can be beneficial for low-powered devices that may struggle with processing heavy JavaScript applications.
+- **Better accessibility:** the content is immediately available on the initial page load, improving accessibility for users who rely on screen readers or other assistive technologies.
+- **Easier caching:** pages can be cached on the server-side, which can further improve performance by reducing the amount of time it takes to generate and send the content to the client.
+::
+
+Overall, server-side rendering can provide a faster and more efficient user experience, as well as improve search engine optimization and accessibility.
+
+As Nuxt is a versatile framework, it gives you the possibility to statically render your whole application to a static hosting with `nuxt generate`,
+disable SSR globally with the `ssr: false` option or leverage hybrid rendering by setting up the `routeRules` option.
+
+::alert{type="info"}
+Read more about the [Nuxt rendering modes](/docs/guide/concepts/rendering).
+::
+
+### Server engine
+
+The Nuxt server engine [Nitro](https://nitro.unjs.io) unlocks new full-stack capabilities.
+
+In development, it uses Rollup and Node.js workers for your server code and context isolation. It also generates your server API by reading files in `server/api/` and server middleware from `server/middleware/`.
+
+In production, Nitro builds your app and server into one universal `.output` directory. This output is light: minified and removed from any Node.js modules (except polyfills). You can deploy this output on any system supporting JavaScript, from Node.js, Serverless, Workers, Edge-side rendering or purely static.
+
+::alert{type="info"}
+Read more about [Nuxt server engine](/docs/guide/concepts/server-engine).
+::
+
+### Production-ready
+
+A Nuxt application can be deployed on a Node or Deno server, pre-rendered to be hosted in static environments, or deployed to serverless and edge providers.
+
+::alert{type="info"}
+Discover more in the [deployment section](/docs/getting-started/deployment).
+::
+
+### Modular
+
+A module system allows to extend Nuxt with custom features and integrations with third-party services.
+
+::alert{type="info"}
+Discover more about [modules](/docs/guide/concepts/modules).
+::
+
+### Architecture
+
+Nuxt is composed of different [core packages](https://github.com/nuxt/nuxt/tree/main/packages):
+
+::list{type=info}
+- Core Engine: [nuxt](https://github.com/nuxt/nuxt/tree/main/packages/nuxt)
+- Bundlers: [@nuxt/vite-builder](https://github.com/nuxt/nuxt/tree/main/packages/vite) and [@nuxt/webpack-builder](https://github.com/nuxt/nuxt/tree/main/packages/webpack)
+- Command line interface: [nuxi](https://github.com/nuxt/nuxt/tree/main/packages/nuxi)
+- Server engine: [nitro](https://github.com/unjs/nitro)
+- Development kit: [@nuxt/kit](https://github.com/nuxt/nuxt/tree/main/packages/kit)
+- Nuxt 2 Bridge: [@nuxt/bridge](https://github.com/nuxt/bridge)
+::
+
+We recommend reading each concept to have a full vision of Nuxt capabilities and the scope of each package.
+
+::card-list
---
-is: 'div'
-gradientBorder: false
-descriptionClass: 'w-full sm:w-2/3'
-buttonsWrapperClass: 'pr-[100px] sm:pr-0'
-backgroundImage:
- path: '/assets/docs/getting-started/views/getting-started'
- width: '100'
- height: '100'
- format: 'png'
-buttons:
- - label: 'Get started'
- size: 'sm'
- variant: 'primary-gradient'
- to: '/docs/getting-started/introduction'
- - label: 'Explore Examples'
- size: 'sm'
- variant: 'secondary'
- to: '/docs/examples/essentials/hello-world'
+cardListClass: 'grid grid-cols-1 gap-y-4'
---
-#title
-Getting Started
-#description
-Start by learning Nuxt core features, from installation to deployment.
-::
-
-
-
-::docs-landing-section
-#title
-Guide
-#description
-From an idea to a masterpiece, guides take you on the path to becoming a Nuxter.
-#extra
- ::card-list
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/key-concepts'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/guide/concepts/auto-imports'
- ---
- #title
- Key Concepts
- #description
- Get an overview of the concepts that drive the Nuxt experience.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/directory-structure'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/guide/directory-structure/nuxt'
- ---
- #title
- Directory Structure
- #description
- Navigate Nuxt directory structure with this handy guide.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/going-further'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/guide/going-further/internals'
- ---
- #title
- Going further
- #description
- Deep dive into Nuxt internals to master all the features.
- :::
- ::
-::
-
-::docs-landing-section
-#title
-API
-#description
-Every Nuxt components, composables and utilities, in details.
-#extra
- ::card-list
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/composables'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/composables/use-app-config'
- ---
- #title
- Composables
- #description
- From data fetching to error handling, get familiar with Nuxt built-in composables.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/components'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/components/client-only'
- ---
- #title
- Components
- #description
- Nuxt components, auto-imported and ready to use in your application.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/utils'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/utils/dollarfetch'
- ---
- #title
- Utils
- #description
- Use utility functions to get fine-grained control over your app behavior.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/advanced'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/advanced/hooks'
- ---
- #title
- Advanced
- #description
- Learn about lifecycle hooks and Kit utilities in the advanced section.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/commands'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/commands/add'
- ---
- #title
- Commands
- #description
- Meet Nuxi, Nuxt 3 command-line tool. The essential companion in your journey.
- :::
- :::card-item
- ---
- gradientBorder: false
- headerClass: 'justify-start px-4 pt-4 sm:px-6'
- image:
- path: '/assets/docs/getting-started/views/docs-landing/configuration'
- width: '52'
- height: '58'
- format: 'svg'
- contentClass: 'gap-y-2'
- to: '/docs/api/configuration/nuxt-config'
- ---
- #title
- Configuration
- #description
- Master the Nuxt config file to customize the framework behavior.
- :::
- ::
+ :::card-item
+ ---
+ gradientBorder: false
+ backgroundImage:
+ path: '/assets/docs/getting-started/views/are-you-nuxt'
+ width: '72px'
+ height: '92px'
+ format: 'png'
+ titleClass: 'text-5xl font-semibold u-text-gray-900 pb-2'
+ descriptionClass: 'md:mr-[64px] w-[90%]'
+ ---
+ #title
+ Are you Nuxt?
+ #description
+ Nuxt is the backbone of your Vue.js project, giving structure to build your project with confidence while keeping flexibility.
+
+
+ Extendable with a strong module ecosystem and hooks engine, it makes it easy to connect your REST or GraphQL endpoints, favorite CMS, CSS frameworks and more. PWA and AMP support is only a module away from your Nuxt project.
+
+
+ Ready to try? Head over to the [Installation section](/docs/getting-started/installation).
+ :::
+
+ :::card-item
+ ---
+ gradientBorder: false
+ backgroundImage:
+ path: '/assets/docs/getting-started/views/contribute'
+ width: '72'
+ height: '92'
+ format: 'png'
+ titleClass: 'text-2xl u-text-gray-900 font-semibold'
+ descriptionClass: 'md:mr-[64px]'
+ ---
+ #title
+ Contribute
+ #description
+ Do you want to get involved in the evolution of Nuxt?
+
+ Follow the [contribution guide](/docs/community/contribution).
+ :::
::
diff --git a/docs/2.guide/1.concepts/1.auto-imports.md b/docs/0.prologue/1.auto-imports.md
similarity index 100%
rename from docs/2.guide/1.concepts/1.auto-imports.md
rename to docs/0.prologue/1.auto-imports.md
diff --git a/docs/2.guide/1.concepts/2.vuejs-development.md b/docs/0.prologue/2.vuejs-development.md
similarity index 100%
rename from docs/2.guide/1.concepts/2.vuejs-development.md
rename to docs/0.prologue/2.vuejs-development.md
diff --git a/docs/2.guide/1.concepts/3.rendering.md b/docs/0.prologue/3.rendering.md
similarity index 100%
rename from docs/2.guide/1.concepts/3.rendering.md
rename to docs/0.prologue/3.rendering.md
diff --git a/docs/2.guide/1.concepts/4.server-engine.md b/docs/0.prologue/4.server-engine.md
similarity index 100%
rename from docs/2.guide/1.concepts/4.server-engine.md
rename to docs/0.prologue/4.server-engine.md
diff --git a/docs/2.guide/1.concepts/7.esm.md b/docs/0.prologue/7.esm.md
similarity index 100%
rename from docs/2.guide/1.concepts/7.esm.md
rename to docs/0.prologue/7.esm.md
diff --git a/docs/2.guide/1.concepts/8.typescript.md b/docs/0.prologue/8.typescript.md
similarity index 100%
rename from docs/2.guide/1.concepts/8.typescript.md
rename to docs/0.prologue/8.typescript.md
diff --git a/docs/2.guide/1.concepts/_dir.yml b/docs/0.prologue/_dir.yml
similarity index 57%
rename from docs/2.guide/1.concepts/_dir.yml
rename to docs/0.prologue/_dir.yml
index f4c81a0d28..774bdb5e5e 100644
--- a/docs/2.guide/1.concepts/_dir.yml
+++ b/docs/0.prologue/_dir.yml
@@ -1,4 +1,4 @@
-title: Key Concepts
+title: Prologue
titleTemplate: '%s · Nuxt Concepts'
-navigation.icon: uil:award-alt
+navigation.icon: heroicons:light-bulb
image: '/socials/key-concepts.jpg'
diff --git a/docs/2.guide/1.concepts/index.md b/docs/0.prologue/index.md
similarity index 100%
rename from docs/2.guide/1.concepts/index.md
rename to docs/0.prologue/index.md
diff --git a/docs/1.getting-started/1.introduction.md b/docs/1.getting-started/1.introduction.md
deleted file mode 100644
index 30ed20987d..0000000000
--- a/docs/1.getting-started/1.introduction.md
+++ /dev/null
@@ -1,139 +0,0 @@
----
-navigation.icon: uil:info-circle
-description: Nuxt's goal is to make web development intuitive and performant with a great Developer Experience in mind.
----
-
-# Introduction
-
-Nuxt is a free and [open-source framework](https://github.com/nuxt/nuxt) with an intuitive and extendable way to create type-safe, performant and production-grade full-stack web applications and websites with [Vue.js](https://vuejs.org).
-
-We made everything so you can start writing `.vue` files from the beginning while enjoying hot module replacement in development and a performant application in production with server-side rendering by default.
-
-Nuxt has no vendor lock-in, allowing you to deploy your application [**anywhere, even to the edge**](/docs/getting-started/deployment).
-
-## Automation and Conventions
-
-Nuxt uses conventions and an opinionated directory structure to automate repetitive tasks and allow developers to focus on pushing features. The configuration file can still customize and override its default behaviors.
-
-::list{type=success}
-- **File-based routing:** define routes based on the structure of your [`pages/` directory](/docs/guide/directory-structure/pages). This can make it easier to organize your application and avoid the need for manual route configuration.
-- **Code splitting:** Nuxt automatically splits your code into smaller chunks, which can help reduce the initial load time of your application.
-- **Server-side rendering out of the box:** Nuxt comes with built-in SSR capabilities, so you don't have to set up a separate server yourself.
-- **Auto-imports:** write Vue composables and components in their respectives directories and use them without having to import them with the benefits of tree-shaking and optimised JS bundles.
-- **Data-fetching utilities:** Nuxt provides composables to handle SSR-compatible data fetching as well as different strategies.
-- **Zero-config TypeScript support:** write type-safe code without having to learn TypeScript with our auto-generated types and `tsconfig.json`
-- **Configured build tools:** we use [Vite](https://vitejs.dev) by default to support hot module replacement (HMR) in development and bundling your code for production with best-practices baked-in.
-::
-
-Nuxt takes care of these and provides both frontend and backend functionality so you can focus on what matters: **creating your web application**.
-
-## Server-Side Rendering
-
-Nuxt comes with built-in server-side rendering (SSR) capabilities by default, without having to configure a server yourself, which has many benefits for web applications:
-
-::list{type=success}
-- **Faster initial page load time:** Nuxt sends a fully rendered HTML page to the browser, which can be displayed immediately. This can provide a faster perceived page load time and a better user experience (UX), especially on slower networks or devices.
-- **Improved SEO:** search engines can better index SSR pages because the HTML content is available immediately, rather than requiring JavaScript to render the content on the client-side.
-- **Better performance on low-powered devices:** it reduces the amount of JavaScript that needs to be downloaded and executed on the client-side, which can be beneficial for low-powered devices that may struggle with processing heavy JavaScript applications.
-- **Better accessibility:** the content is immediately available on the initial page load, improving accessibility for users who rely on screen readers or other assistive technologies.
-- **Easier caching:** pages can be cached on the server-side, which can further improve performance by reducing the amount of time it takes to generate and send the content to the client.
-::
-
-Overall, server-side rendering can provide a faster and more efficient user experience, as well as improve search engine optimization and accessibility.
-
-As Nuxt is a versatile framework, it gives you the possibility to statically render your whole application to a static hosting with `nuxt generate`,
-disable SSR globally with the `ssr: false` option or leverage hybrid rendering by setting up the `routeRules` option.
-
-::alert{type="info"}
-Read more about the [Nuxt rendering modes](/docs/guide/concepts/rendering).
-::
-
-### Server engine
-
-The Nuxt server engine [Nitro](https://nitro.unjs.io) unlocks new full-stack capabilities.
-
-In development, it uses Rollup and Node.js workers for your server code and context isolation. It also generates your server API by reading files in `server/api/` and server middleware from `server/middleware/`.
-
-In production, Nitro builds your app and server into one universal `.output` directory. This output is light: minified and removed from any Node.js modules (except polyfills). You can deploy this output on any system supporting JavaScript, from Node.js, Serverless, Workers, Edge-side rendering or purely static.
-
-::alert{type="info"}
-Read more about [Nuxt server engine](/docs/guide/concepts/server-engine).
-::
-
-### Production-ready
-
-A Nuxt application can be deployed on a Node or Deno server, pre-rendered to be hosted in static environments, or deployed to serverless and edge providers.
-
-::alert{type="info"}
-Discover more in the [deployment section](/docs/getting-started/deployment).
-::
-
-### Modular
-
-A module system allows to extend Nuxt with custom features and integrations with third-party services.
-
-::alert{type="info"}
-Discover more about [modules](/docs/guide/concepts/modules).
-::
-
-### Architecture
-
-Nuxt is composed of different [core packages](https://github.com/nuxt/nuxt/tree/main/packages):
-
-::list{type=info}
-- Core Engine: [nuxt](https://github.com/nuxt/nuxt/tree/main/packages/nuxt)
-- Bundlers: [@nuxt/vite-builder](https://github.com/nuxt/nuxt/tree/main/packages/vite) and [@nuxt/webpack-builder](https://github.com/nuxt/nuxt/tree/main/packages/webpack)
-- Command line interface: [nuxi](https://github.com/nuxt/nuxt/tree/main/packages/nuxi)
-- Server engine: [nitro](https://github.com/unjs/nitro)
-- Development kit: [@nuxt/kit](https://github.com/nuxt/nuxt/tree/main/packages/kit)
-- Nuxt 2 Bridge: [@nuxt/bridge](https://github.com/nuxt/bridge)
-::
-
-We recommend reading each concept to have a full vision of Nuxt capabilities and the scope of each package.
-
-::card-list
----
-cardListClass: 'grid grid-cols-1 gap-y-4'
----
- :::card-item
- ---
- gradientBorder: false
- backgroundImage:
- path: '/assets/docs/getting-started/views/are-you-nuxt'
- width: '72px'
- height: '92px'
- format: 'png'
- titleClass: 'text-5xl font-semibold u-text-gray-900 pb-2'
- descriptionClass: 'md:mr-[64px] w-[90%]'
- ---
- #title
- Are you Nuxt?
- #description
- Nuxt is the backbone of your Vue.js project, giving structure to build your project with confidence while keeping flexibility.
-
-
- Extendable with a strong module ecosystem and hooks engine, it makes it easy to connect your REST or GraphQL endpoints, favorite CMS, CSS frameworks and more. PWA and AMP support is only a module away from your Nuxt project.
-
-
- Ready to try? Head over to the [Installation section](/docs/getting-started/installation).
- :::
-
- :::card-item
- ---
- gradientBorder: false
- backgroundImage:
- path: '/assets/docs/getting-started/views/contribute'
- width: '72'
- height: '92'
- format: 'png'
- titleClass: 'text-2xl u-text-gray-900 font-semibold'
- descriptionClass: 'md:mr-[64px]'
- ---
- #title
- Contribute
- #description
- Do you want to get involved in the evolution of Nuxt?
-
- Follow the [contribution guide](/docs/community/contribution).
- :::
-::
diff --git a/docs/1.getting-started/_dir.yml b/docs/1.getting-started/_dir.yml
index 538f390e40..dc56101d26 100644
--- a/docs/1.getting-started/_dir.yml
+++ b/docs/1.getting-started/_dir.yml
@@ -1,3 +1,4 @@
title: Get Started
titleTemplate: '%s · Get Started with Nuxt'
image: '/socials/get-started.jpg'
+navigation.icon: heroicons:rocket-launch
diff --git a/docs/2.directory-structure/0.index.md b/docs/2.directory-structure/0.index.md
new file mode 100644
index 0000000000..6bede2d6ce
--- /dev/null
+++ b/docs/2.directory-structure/0.index.md
@@ -0,0 +1,5 @@
+---
+navigation.title: Introduction
+---
+
+# Directory Structure
diff --git a/docs/2.guide/2.directory-structure/0.nuxt.md b/docs/2.directory-structure/0.nuxt.md
similarity index 93%
rename from docs/2.guide/2.directory-structure/0.nuxt.md
rename to docs/2.directory-structure/0.nuxt.md
index 49c5a0e997..88a31e04f0 100644
--- a/docs/2.guide/2.directory-structure/0.nuxt.md
+++ b/docs/2.directory-structure/0.nuxt.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: ".nuxt"
+title: ".nuxt/"
description: "Nuxt uses the .nuxt/ directory in development to generate your Vue application."
head.title: ".nuxt/"
---
diff --git a/docs/2.guide/2.directory-structure/0.output.md b/docs/2.directory-structure/0.output.md
similarity index 91%
rename from docs/2.guide/2.directory-structure/0.output.md
rename to docs/2.directory-structure/0.output.md
index 016c13b7aa..daa006ae70 100644
--- a/docs/2.guide/2.directory-structure/0.output.md
+++ b/docs/2.directory-structure/0.output.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: ".output"
+title: ".output/"
description: "Nuxt creates the .output/ directory when building your application for production."
head.title: ".output/"
---
diff --git a/docs/2.guide/2.directory-structure/1.assets.md b/docs/2.directory-structure/1.assets.md
similarity index 93%
rename from docs/2.guide/2.directory-structure/1.assets.md
rename to docs/2.directory-structure/1.assets.md
index 5e4dc73743..2fc3a9d0a8 100644
--- a/docs/2.guide/2.directory-structure/1.assets.md
+++ b/docs/2.directory-structure/1.assets.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "assets"
+title: "assets/"
description: "The assets/ directory is used to add all the website's assets that the build tool will process."
head.title: "assets/"
---
diff --git a/docs/2.guide/2.directory-structure/1.components.md b/docs/2.directory-structure/1.components.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/1.components.md
rename to docs/2.directory-structure/1.components.md
index 7a39da99f6..ea6d7150ac 100644
--- a/docs/2.guide/2.directory-structure/1.components.md
+++ b/docs/2.directory-structure/1.components.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "components"
+title: "components/"
description: "The components/ directory is where you put all your Vue components."
head.title: "components/"
---
diff --git a/docs/2.guide/2.directory-structure/1.composables.md b/docs/2.directory-structure/1.composables.md
similarity index 98%
rename from docs/2.guide/2.directory-structure/1.composables.md
rename to docs/2.directory-structure/1.composables.md
index bd7e9f5153..201e1ae379 100644
--- a/docs/2.guide/2.directory-structure/1.composables.md
+++ b/docs/2.directory-structure/1.composables.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: 'composables'
+title: 'composables/'
head.title: 'composables/'
description: Use the composables/ directory to auto-import your Vue composables into your application.
---
diff --git a/docs/2.guide/2.directory-structure/1.content.md b/docs/2.directory-structure/1.content.md
similarity index 97%
rename from docs/2.guide/2.directory-structure/1.content.md
rename to docs/2.directory-structure/1.content.md
index 283f8177a1..e6e8e1478b 100644
--- a/docs/2.guide/2.directory-structure/1.content.md
+++ b/docs/2.directory-structure/1.content.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: 'content'
+title: 'content/'
head.title: 'content/'
description: The Content module reads the content/ directory to create a file-based CMS for your application.
---
diff --git a/docs/2.guide/2.directory-structure/1.layouts.md b/docs/2.directory-structure/1.layouts.md
similarity index 98%
rename from docs/2.guide/2.directory-structure/1.layouts.md
rename to docs/2.directory-structure/1.layouts.md
index 476c05d3ed..4a214428eb 100644
--- a/docs/2.guide/2.directory-structure/1.layouts.md
+++ b/docs/2.directory-structure/1.layouts.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "layouts"
+title: "layouts/"
description: "Nuxt provides a layouts framework to extract common UI patterns into reusable layouts."
head.title: "layouts/"
---
diff --git a/docs/2.guide/2.directory-structure/1.middleware.md b/docs/2.directory-structure/1.middleware.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/1.middleware.md
rename to docs/2.directory-structure/1.middleware.md
index 9ba3557915..d2ac86990a 100644
--- a/docs/2.guide/2.directory-structure/1.middleware.md
+++ b/docs/2.directory-structure/1.middleware.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "middleware"
+title: "middleware/"
description: "Nuxt provides middleware to run code before navigating to a particular route."
head.title: "middleware/"
---
diff --git a/docs/2.guide/2.directory-structure/1.modules.md b/docs/2.directory-structure/1.modules.md
similarity index 97%
rename from docs/2.guide/2.directory-structure/1.modules.md
rename to docs/2.directory-structure/1.modules.md
index fc9c51c341..4699f8f7f5 100644
--- a/docs/2.guide/2.directory-structure/1.modules.md
+++ b/docs/2.directory-structure/1.modules.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: 'modules'
+title: 'modules/'
head.title: 'modules/'
description: Use the modules/ directory to automatically register local modules within your application.
---
diff --git a/docs/2.guide/2.directory-structure/1.node_modules.md b/docs/2.directory-structure/1.node_modules.md
similarity index 88%
rename from docs/2.guide/2.directory-structure/1.node_modules.md
rename to docs/2.directory-structure/1.node_modules.md
index 93fc765868..8bf4e1ebf0 100644
--- a/docs/2.guide/2.directory-structure/1.node_modules.md
+++ b/docs/2.directory-structure/1.node_modules.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "node_modules"
+title: "node_modules/"
description: "The package manager stores the dependencies of your project in the node_modules/ directory."
head.title: "node_modules/"
---
diff --git a/docs/2.guide/2.directory-structure/1.pages.md b/docs/2.directory-structure/1.pages.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/1.pages.md
rename to docs/2.directory-structure/1.pages.md
index d39c493eed..0b605d1dd5 100644
--- a/docs/2.guide/2.directory-structure/1.pages.md
+++ b/docs/2.directory-structure/1.pages.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "pages"
+title: "pages/"
description: "Nuxt provides a file-based routing to create routes within your web application."
head.title: "pages/"
---
diff --git a/docs/2.guide/2.directory-structure/1.plugins.md b/docs/2.directory-structure/1.plugins.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/1.plugins.md
rename to docs/2.directory-structure/1.plugins.md
index b24ef8a0dd..8d2665f435 100644
--- a/docs/2.guide/2.directory-structure/1.plugins.md
+++ b/docs/2.directory-structure/1.plugins.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "plugins"
+title: "plugins/"
description: "Nuxt reads the files in your plugins directory and loads them at the creation of the Vue application."
head.title: "plugins/"
---
diff --git a/docs/2.guide/2.directory-structure/1.public.md b/docs/2.directory-structure/1.public.md
similarity index 90%
rename from docs/2.guide/2.directory-structure/1.public.md
rename to docs/2.directory-structure/1.public.md
index 0871b867b9..90fc690454 100644
--- a/docs/2.guide/2.directory-structure/1.public.md
+++ b/docs/2.directory-structure/1.public.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: "public"
+title: "public/"
description: "The public/ directory is used to serve your website's static assets."
head.title: "public/"
---
diff --git a/docs/2.guide/2.directory-structure/1.server.md b/docs/2.directory-structure/1.server.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/1.server.md
rename to docs/2.directory-structure/1.server.md
index 36927a446f..a1f80b2608 100644
--- a/docs/2.guide/2.directory-structure/1.server.md
+++ b/docs/2.directory-structure/1.server.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: server
+title: 'server/'
head.title: 'server/'
description: The server/ directory is used to register API and server handlers to your application.
---
diff --git a/docs/2.guide/2.directory-structure/1.utils.md b/docs/2.directory-structure/1.utils.md
similarity index 95%
rename from docs/2.guide/2.directory-structure/1.utils.md
rename to docs/2.directory-structure/1.utils.md
index 212550c517..5cab769ff2 100644
--- a/docs/2.guide/2.directory-structure/1.utils.md
+++ b/docs/2.directory-structure/1.utils.md
@@ -1,6 +1,5 @@
---
-navigation.icon: IconDirectory
-title: 'utils'
+title: 'utils/'
head.title: 'utils/'
description: Use the utils/ directory to auto-import your utility functions throughout your application.
---
diff --git a/docs/2.guide/2.directory-structure/2.env.md b/docs/2.directory-structure/2.env.md
similarity index 98%
rename from docs/2.guide/2.directory-structure/2.env.md
rename to docs/2.directory-structure/2.env.md
index 6350415755..57543c1847 100644
--- a/docs/2.guide/2.directory-structure/2.env.md
+++ b/docs/2.directory-structure/2.env.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: ".env"
description: "A .env file specifies your build/dev-time environment variables."
head.title: ".env"
diff --git a/docs/2.guide/2.directory-structure/2.gitignore.md b/docs/2.directory-structure/2.gitignore.md
similarity index 95%
rename from docs/2.guide/2.directory-structure/2.gitignore.md
rename to docs/2.directory-structure/2.gitignore.md
index 8760500a31..c8f273a094 100644
--- a/docs/2.guide/2.directory-structure/2.gitignore.md
+++ b/docs/2.directory-structure/2.gitignore.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: ".gitignore"
description: "A .gitignore file specifies intentionally untracked files that git should ignore."
head.title: ".gitignore"
diff --git a/docs/2.guide/2.directory-structure/2.nuxtignore.md b/docs/2.directory-structure/2.nuxtignore.md
similarity index 98%
rename from docs/2.guide/2.directory-structure/2.nuxtignore.md
rename to docs/2.directory-structure/2.nuxtignore.md
index 67763da971..7126e5977e 100644
--- a/docs/2.guide/2.directory-structure/2.nuxtignore.md
+++ b/docs/2.directory-structure/2.nuxtignore.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: .nuxtignore
head.title: '.nuxtignore'
description: The .nuxtignore file lets Nuxt ignore files in your project’s root directory during the build phase.
diff --git a/docs/2.guide/2.directory-structure/3.app-config.md b/docs/2.directory-structure/3.app-config.md
similarity index 99%
rename from docs/2.guide/2.directory-structure/3.app-config.md
rename to docs/2.directory-structure/3.app-config.md
index a4719428bc..3339cd739b 100644
--- a/docs/2.guide/2.directory-structure/3.app-config.md
+++ b/docs/2.directory-structure/3.app-config.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: app.config.ts
head.title: 'app.config.ts'
description: Nuxt 3 provides the app.config file to expose reactive configuration within your application.
diff --git a/docs/2.guide/2.directory-structure/3.app.md b/docs/2.directory-structure/3.app.md
similarity index 98%
rename from docs/2.guide/2.directory-structure/3.app.md
rename to docs/2.directory-structure/3.app.md
index dc8a5744ec..ea425191ec 100644
--- a/docs/2.guide/2.directory-structure/3.app.md
+++ b/docs/2.directory-structure/3.app.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: "app.vue"
description: "The app.vue file is the main component in your Nuxt 3 applications."
head.title: "app.vue"
diff --git a/docs/2.guide/2.directory-structure/3.nuxt.config.md b/docs/2.directory-structure/3.nuxt.config.md
similarity index 97%
rename from docs/2.guide/2.directory-structure/3.nuxt.config.md
rename to docs/2.directory-structure/3.nuxt.config.md
index fda0cee7b8..9684ab71e7 100644
--- a/docs/2.guide/2.directory-structure/3.nuxt.config.md
+++ b/docs/2.directory-structure/3.nuxt.config.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: "nuxt.config.ts"
description: "Nuxt can be easily configured with a single nuxt.config file."
head.title: "nuxt.config.ts"
diff --git a/docs/2.guide/2.directory-structure/3.package.md b/docs/2.directory-structure/3.package.md
similarity index 92%
rename from docs/2.guide/2.directory-structure/3.package.md
rename to docs/2.directory-structure/3.package.md
index e634262559..c96eddc7d2 100644
--- a/docs/2.guide/2.directory-structure/3.package.md
+++ b/docs/2.directory-structure/3.package.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: package.json
head.title: package.json
description: The package.json file contains all the dependencies and scripts for your application.
diff --git a/docs/2.guide/2.directory-structure/3.tsconfig.md b/docs/2.directory-structure/3.tsconfig.md
similarity index 97%
rename from docs/2.guide/2.directory-structure/3.tsconfig.md
rename to docs/2.directory-structure/3.tsconfig.md
index 8210ce9d4c..f0b10238e1 100644
--- a/docs/2.guide/2.directory-structure/3.tsconfig.md
+++ b/docs/2.directory-structure/3.tsconfig.md
@@ -1,5 +1,4 @@
---
-navigation.icon: IconFile
title: "tsconfig.json"
description: "Nuxt generates a .nuxt/tsconfig.json file with sensible defaults and your aliases."
head.title: "tsconfig.json"
diff --git a/docs/2.guide/2.directory-structure/_dir.yml b/docs/2.directory-structure/_dir.yml
similarity index 75%
rename from docs/2.guide/2.directory-structure/_dir.yml
rename to docs/2.directory-structure/_dir.yml
index af618270a4..e455d16193 100644
--- a/docs/2.guide/2.directory-structure/_dir.yml
+++ b/docs/2.directory-structure/_dir.yml
@@ -1,4 +1,4 @@
title: Directory Structure
titleTemplate: '%s · Nuxt Directory Structure'
-navigation.icon: uil:folder-open
+navigation.icon: heroicons:folder-open
image: '/socials/directory-structure.jpg'
diff --git a/docs/2.guide/2.directory-structure/index.md b/docs/2.guide/2.directory-structure/index.md
deleted file mode 100644
index 1f32316657..0000000000
--- a/docs/2.guide/2.directory-structure/index.md
+++ /dev/null
@@ -1,4 +0,0 @@
----
-navigation: false
-redirect: /guide/directory-structure/nuxt
----
diff --git a/docs/2.guide/_dir.yml b/docs/2.guide/_dir.yml
deleted file mode 100644
index 0a85ba1bda..0000000000
--- a/docs/2.guide/_dir.yml
+++ /dev/null
@@ -1 +0,0 @@
-image: '/socials/guide.jpg'
diff --git a/docs/2.guide/index.md b/docs/2.guide/index.md
deleted file mode 100644
index 7c00ce8cee..0000000000
--- a/docs/2.guide/index.md
+++ /dev/null
@@ -1,4 +0,0 @@
----
-navigation: false
-redirect: /guide/concepts/auto-imports
----
diff --git a/docs/3.api/_dir.yml b/docs/3.api/_dir.yml
deleted file mode 100644
index a3cfd7a8dd..0000000000
--- a/docs/3.api/_dir.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-title: API
-image: '/socials/api.jpg'
diff --git a/docs/2.guide/1.concepts/5.modules.md b/docs/3.modules/0.index.md
similarity index 98%
rename from docs/2.guide/1.concepts/5.modules.md
rename to docs/3.modules/0.index.md
index 818c5caa4d..b33f85f31a 100644
--- a/docs/2.guide/1.concepts/5.modules.md
+++ b/docs/3.modules/0.index.md
@@ -1,4 +1,5 @@
---
+navigation.title: 'Introduction'
description: "Nuxt provides a module system to extend the framework core and simplify integrations."
---
diff --git a/docs/3.modules/_dir.yml b/docs/3.modules/_dir.yml
new file mode 100644
index 0000000000..4ea19c0d7c
--- /dev/null
+++ b/docs/3.modules/_dir.yml
@@ -0,0 +1,2 @@
+navigation.icon: heroicons:puzzle-piece
+title: Modules
diff --git a/docs/3.modules/adapters.md b/docs/3.modules/adapters.md
new file mode 100644
index 0000000000..59632874cd
--- /dev/null
+++ b/docs/3.modules/adapters.md
@@ -0,0 +1 @@
+Adapter for companies/SAAS, Electron, Ionic, Adsense
diff --git a/docs/3.modules/analytics.md b/docs/3.modules/analytics.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/cms.md b/docs/3.modules/cms.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/commerce.md b/docs/3.modules/commerce.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/database.md b/docs/3.modules/database.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/ecosystem.md b/docs/3.modules/ecosystem.md
new file mode 100644
index 0000000000..deee47443c
--- /dev/null
+++ b/docs/3.modules/ecosystem.md
@@ -0,0 +1 @@
+Build by the Vite/Vue community to help development (Pinia, Regexp, etc.) as well as open source connectors
diff --git a/docs/3.modules/forms.md b/docs/3.modules/forms.md
new file mode 100644
index 0000000000..fb1539fe04
--- /dev/null
+++ b/docs/3.modules/forms.md
@@ -0,0 +1 @@
+Search + Formkit
diff --git a/docs/3.modules/monitoring.md b/docs/3.modules/monitoring.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/optimization.md b/docs/3.modules/optimization.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/request.md b/docs/3.modules/request.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/3.modules/seo.md b/docs/3.modules/seo.md
new file mode 100644
index 0000000000..af5eb7443b
--- /dev/null
+++ b/docs/3.modules/seo.md
@@ -0,0 +1,3 @@
+---
+navigation.title: SEO
+---
diff --git a/docs/3.modules/styling.md b/docs/3.modules/styling.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/4.examples/_dir.yml b/docs/4.examples/_dir.yml
index c07d805eac..f2edf25623 100644
--- a/docs/4.examples/_dir.yml
+++ b/docs/4.examples/_dir.yml
@@ -1 +1,2 @@
image: '/socials/examples.jpg'
+navigation.icon: heroicons:code-bracket-square
diff --git a/docs/3.api/1.composables/_dir.yml b/docs/5.api/1.composables/_dir.yml
similarity index 100%
rename from docs/3.api/1.composables/_dir.yml
rename to docs/5.api/1.composables/_dir.yml
diff --git a/docs/3.api/1.composables/use-app-config.md b/docs/5.api/1.composables/use-app-config.md
similarity index 100%
rename from docs/3.api/1.composables/use-app-config.md
rename to docs/5.api/1.composables/use-app-config.md
diff --git a/docs/3.api/1.composables/use-async-data.md b/docs/5.api/1.composables/use-async-data.md
similarity index 100%
rename from docs/3.api/1.composables/use-async-data.md
rename to docs/5.api/1.composables/use-async-data.md
diff --git a/docs/3.api/1.composables/use-cookie.md b/docs/5.api/1.composables/use-cookie.md
similarity index 100%
rename from docs/3.api/1.composables/use-cookie.md
rename to docs/5.api/1.composables/use-cookie.md
diff --git a/docs/3.api/1.composables/use-error.md b/docs/5.api/1.composables/use-error.md
similarity index 100%
rename from docs/3.api/1.composables/use-error.md
rename to docs/5.api/1.composables/use-error.md
diff --git a/docs/3.api/1.composables/use-fetch.md b/docs/5.api/1.composables/use-fetch.md
similarity index 100%
rename from docs/3.api/1.composables/use-fetch.md
rename to docs/5.api/1.composables/use-fetch.md
diff --git a/docs/3.api/1.composables/use-head-safe.md b/docs/5.api/1.composables/use-head-safe.md
similarity index 100%
rename from docs/3.api/1.composables/use-head-safe.md
rename to docs/5.api/1.composables/use-head-safe.md
diff --git a/docs/3.api/1.composables/use-head.md b/docs/5.api/1.composables/use-head.md
similarity index 100%
rename from docs/3.api/1.composables/use-head.md
rename to docs/5.api/1.composables/use-head.md
diff --git a/docs/3.api/1.composables/use-hydration.md b/docs/5.api/1.composables/use-hydration.md
similarity index 100%
rename from docs/3.api/1.composables/use-hydration.md
rename to docs/5.api/1.composables/use-hydration.md
diff --git a/docs/3.api/1.composables/use-lazy-async-data.md b/docs/5.api/1.composables/use-lazy-async-data.md
similarity index 100%
rename from docs/3.api/1.composables/use-lazy-async-data.md
rename to docs/5.api/1.composables/use-lazy-async-data.md
diff --git a/docs/3.api/1.composables/use-lazy-fetch.md b/docs/5.api/1.composables/use-lazy-fetch.md
similarity index 100%
rename from docs/3.api/1.composables/use-lazy-fetch.md
rename to docs/5.api/1.composables/use-lazy-fetch.md
diff --git a/docs/3.api/1.composables/use-nuxt-app.md b/docs/5.api/1.composables/use-nuxt-app.md
similarity index 100%
rename from docs/3.api/1.composables/use-nuxt-app.md
rename to docs/5.api/1.composables/use-nuxt-app.md
diff --git a/docs/3.api/1.composables/use-nuxt-data.md b/docs/5.api/1.composables/use-nuxt-data.md
similarity index 100%
rename from docs/3.api/1.composables/use-nuxt-data.md
rename to docs/5.api/1.composables/use-nuxt-data.md
diff --git a/docs/3.api/1.composables/use-request-event.md b/docs/5.api/1.composables/use-request-event.md
similarity index 100%
rename from docs/3.api/1.composables/use-request-event.md
rename to docs/5.api/1.composables/use-request-event.md
diff --git a/docs/3.api/1.composables/use-request-headers.md b/docs/5.api/1.composables/use-request-headers.md
similarity index 100%
rename from docs/3.api/1.composables/use-request-headers.md
rename to docs/5.api/1.composables/use-request-headers.md
diff --git a/docs/3.api/1.composables/use-route.md b/docs/5.api/1.composables/use-route.md
similarity index 100%
rename from docs/3.api/1.composables/use-route.md
rename to docs/5.api/1.composables/use-route.md
diff --git a/docs/3.api/1.composables/use-router.md b/docs/5.api/1.composables/use-router.md
similarity index 100%
rename from docs/3.api/1.composables/use-router.md
rename to docs/5.api/1.composables/use-router.md
diff --git a/docs/3.api/1.composables/use-runtime-config.md b/docs/5.api/1.composables/use-runtime-config.md
similarity index 100%
rename from docs/3.api/1.composables/use-runtime-config.md
rename to docs/5.api/1.composables/use-runtime-config.md
diff --git a/docs/3.api/1.composables/use-state.md b/docs/5.api/1.composables/use-state.md
similarity index 100%
rename from docs/3.api/1.composables/use-state.md
rename to docs/5.api/1.composables/use-state.md
diff --git a/docs/3.api/2.components/1.client-only.md b/docs/5.api/2.components/1.client-only.md
similarity index 100%
rename from docs/3.api/2.components/1.client-only.md
rename to docs/5.api/2.components/1.client-only.md
diff --git a/docs/3.api/2.components/1.nuxt-client-fallback.md b/docs/5.api/2.components/1.nuxt-client-fallback.md
similarity index 100%
rename from docs/3.api/2.components/1.nuxt-client-fallback.md
rename to docs/5.api/2.components/1.nuxt-client-fallback.md
diff --git a/docs/3.api/2.components/2.nuxt-page.md b/docs/5.api/2.components/2.nuxt-page.md
similarity index 100%
rename from docs/3.api/2.components/2.nuxt-page.md
rename to docs/5.api/2.components/2.nuxt-page.md
diff --git a/docs/3.api/2.components/3.nuxt-layout.md b/docs/5.api/2.components/3.nuxt-layout.md
similarity index 100%
rename from docs/3.api/2.components/3.nuxt-layout.md
rename to docs/5.api/2.components/3.nuxt-layout.md
diff --git a/docs/3.api/2.components/4.nuxt-link.md b/docs/5.api/2.components/4.nuxt-link.md
similarity index 100%
rename from docs/3.api/2.components/4.nuxt-link.md
rename to docs/5.api/2.components/4.nuxt-link.md
diff --git a/docs/3.api/2.components/5.nuxt-loading-indicator.md b/docs/5.api/2.components/5.nuxt-loading-indicator.md
similarity index 100%
rename from docs/3.api/2.components/5.nuxt-loading-indicator.md
rename to docs/5.api/2.components/5.nuxt-loading-indicator.md
diff --git a/docs/3.api/2.components/6.nuxt-error-boundary.md b/docs/5.api/2.components/6.nuxt-error-boundary.md
similarity index 100%
rename from docs/3.api/2.components/6.nuxt-error-boundary.md
rename to docs/5.api/2.components/6.nuxt-error-boundary.md
diff --git a/docs/3.api/2.components/7.nuxt-welcome.md b/docs/5.api/2.components/7.nuxt-welcome.md
similarity index 100%
rename from docs/3.api/2.components/7.nuxt-welcome.md
rename to docs/5.api/2.components/7.nuxt-welcome.md
diff --git a/docs/3.api/2.components/8.teleports.md b/docs/5.api/2.components/8.teleports.md
similarity index 100%
rename from docs/3.api/2.components/8.teleports.md
rename to docs/5.api/2.components/8.teleports.md
diff --git a/docs/3.api/2.components/_dir.yml b/docs/5.api/2.components/_dir.yml
similarity index 100%
rename from docs/3.api/2.components/_dir.yml
rename to docs/5.api/2.components/_dir.yml
diff --git a/docs/3.api/2.components/index.md b/docs/5.api/2.components/index.md
similarity index 100%
rename from docs/3.api/2.components/index.md
rename to docs/5.api/2.components/index.md
diff --git a/docs/3.api/3.utils/$fetch.md b/docs/5.api/3.utils/$fetch.md
similarity index 100%
rename from docs/3.api/3.utils/$fetch.md
rename to docs/5.api/3.utils/$fetch.md
diff --git a/docs/3.api/3.utils/_dir.yml b/docs/5.api/3.utils/_dir.yml
similarity index 100%
rename from docs/3.api/3.utils/_dir.yml
rename to docs/5.api/3.utils/_dir.yml
diff --git a/docs/3.api/3.utils/abort-navigation.md b/docs/5.api/3.utils/abort-navigation.md
similarity index 100%
rename from docs/3.api/3.utils/abort-navigation.md
rename to docs/5.api/3.utils/abort-navigation.md
diff --git a/docs/3.api/3.utils/add-route-middleware.md b/docs/5.api/3.utils/add-route-middleware.md
similarity index 100%
rename from docs/3.api/3.utils/add-route-middleware.md
rename to docs/5.api/3.utils/add-route-middleware.md
diff --git a/docs/3.api/3.utils/clear-error.md b/docs/5.api/3.utils/clear-error.md
similarity index 100%
rename from docs/3.api/3.utils/clear-error.md
rename to docs/5.api/3.utils/clear-error.md
diff --git a/docs/3.api/3.utils/clear-nuxt-data.md b/docs/5.api/3.utils/clear-nuxt-data.md
similarity index 100%
rename from docs/3.api/3.utils/clear-nuxt-data.md
rename to docs/5.api/3.utils/clear-nuxt-data.md
diff --git a/docs/3.api/3.utils/create-error.md b/docs/5.api/3.utils/create-error.md
similarity index 100%
rename from docs/3.api/3.utils/create-error.md
rename to docs/5.api/3.utils/create-error.md
diff --git a/docs/3.api/3.utils/define-nuxt-component.md b/docs/5.api/3.utils/define-nuxt-component.md
similarity index 100%
rename from docs/3.api/3.utils/define-nuxt-component.md
rename to docs/5.api/3.utils/define-nuxt-component.md
diff --git a/docs/3.api/3.utils/define-nuxt-route-middleware.md b/docs/5.api/3.utils/define-nuxt-route-middleware.md
similarity index 100%
rename from docs/3.api/3.utils/define-nuxt-route-middleware.md
rename to docs/5.api/3.utils/define-nuxt-route-middleware.md
diff --git a/docs/3.api/3.utils/define-page-meta.md b/docs/5.api/3.utils/define-page-meta.md
similarity index 100%
rename from docs/3.api/3.utils/define-page-meta.md
rename to docs/5.api/3.utils/define-page-meta.md
diff --git a/docs/3.api/3.utils/index.md b/docs/5.api/3.utils/index.md
similarity index 100%
rename from docs/3.api/3.utils/index.md
rename to docs/5.api/3.utils/index.md
diff --git a/docs/3.api/3.utils/navigate-to.md b/docs/5.api/3.utils/navigate-to.md
similarity index 100%
rename from docs/3.api/3.utils/navigate-to.md
rename to docs/5.api/3.utils/navigate-to.md
diff --git a/docs/3.api/3.utils/on-before-route-leave.md b/docs/5.api/3.utils/on-before-route-leave.md
similarity index 100%
rename from docs/3.api/3.utils/on-before-route-leave.md
rename to docs/5.api/3.utils/on-before-route-leave.md
diff --git a/docs/3.api/3.utils/on-before-route-update.md b/docs/5.api/3.utils/on-before-route-update.md
similarity index 100%
rename from docs/3.api/3.utils/on-before-route-update.md
rename to docs/5.api/3.utils/on-before-route-update.md
diff --git a/docs/3.api/3.utils/on-nuxt-ready.md b/docs/5.api/3.utils/on-nuxt-ready.md
similarity index 100%
rename from docs/3.api/3.utils/on-nuxt-ready.md
rename to docs/5.api/3.utils/on-nuxt-ready.md
diff --git a/docs/3.api/3.utils/prefetch-components.md b/docs/5.api/3.utils/prefetch-components.md
similarity index 100%
rename from docs/3.api/3.utils/prefetch-components.md
rename to docs/5.api/3.utils/prefetch-components.md
diff --git a/docs/3.api/3.utils/preload-components.md b/docs/5.api/3.utils/preload-components.md
similarity index 100%
rename from docs/3.api/3.utils/preload-components.md
rename to docs/5.api/3.utils/preload-components.md
diff --git a/docs/3.api/3.utils/preload-route-components.md b/docs/5.api/3.utils/preload-route-components.md
similarity index 100%
rename from docs/3.api/3.utils/preload-route-components.md
rename to docs/5.api/3.utils/preload-route-components.md
diff --git a/docs/3.api/3.utils/refresh-nuxt-data.md b/docs/5.api/3.utils/refresh-nuxt-data.md
similarity index 100%
rename from docs/3.api/3.utils/refresh-nuxt-data.md
rename to docs/5.api/3.utils/refresh-nuxt-data.md
diff --git a/docs/3.api/3.utils/reload-nuxt-app.md b/docs/5.api/3.utils/reload-nuxt-app.md
similarity index 100%
rename from docs/3.api/3.utils/reload-nuxt-app.md
rename to docs/5.api/3.utils/reload-nuxt-app.md
diff --git a/docs/3.api/3.utils/set-page-layout.md b/docs/5.api/3.utils/set-page-layout.md
similarity index 100%
rename from docs/3.api/3.utils/set-page-layout.md
rename to docs/5.api/3.utils/set-page-layout.md
diff --git a/docs/3.api/3.utils/set-response-status.md b/docs/5.api/3.utils/set-response-status.md
similarity index 100%
rename from docs/3.api/3.utils/set-response-status.md
rename to docs/5.api/3.utils/set-response-status.md
diff --git a/docs/3.api/3.utils/show-error.md b/docs/5.api/3.utils/show-error.md
similarity index 100%
rename from docs/3.api/3.utils/show-error.md
rename to docs/5.api/3.utils/show-error.md
diff --git a/docs/3.api/3.utils/update-app-config.md b/docs/5.api/3.utils/update-app-config.md
similarity index 100%
rename from docs/3.api/3.utils/update-app-config.md
rename to docs/5.api/3.utils/update-app-config.md
diff --git a/docs/3.api/4.advanced/1.hooks.md b/docs/5.api/4.advanced/1.hooks.md
similarity index 100%
rename from docs/3.api/4.advanced/1.hooks.md
rename to docs/5.api/4.advanced/1.hooks.md
diff --git a/docs/3.api/4.advanced/2.kit.md b/docs/5.api/4.advanced/2.kit.md
similarity index 100%
rename from docs/3.api/4.advanced/2.kit.md
rename to docs/5.api/4.advanced/2.kit.md
diff --git a/docs/3.api/4.advanced/_dir.yml b/docs/5.api/4.advanced/_dir.yml
similarity index 100%
rename from docs/3.api/4.advanced/_dir.yml
rename to docs/5.api/4.advanced/_dir.yml
diff --git a/docs/3.api/5.commands/_dir.yml b/docs/5.api/5.commands/_dir.yml
similarity index 100%
rename from docs/3.api/5.commands/_dir.yml
rename to docs/5.api/5.commands/_dir.yml
diff --git a/docs/3.api/5.commands/add.md b/docs/5.api/5.commands/add.md
similarity index 100%
rename from docs/3.api/5.commands/add.md
rename to docs/5.api/5.commands/add.md
diff --git a/docs/3.api/5.commands/analyze.md b/docs/5.api/5.commands/analyze.md
similarity index 100%
rename from docs/3.api/5.commands/analyze.md
rename to docs/5.api/5.commands/analyze.md
diff --git a/docs/3.api/5.commands/build-module.md b/docs/5.api/5.commands/build-module.md
similarity index 100%
rename from docs/3.api/5.commands/build-module.md
rename to docs/5.api/5.commands/build-module.md
diff --git a/docs/3.api/5.commands/build.md b/docs/5.api/5.commands/build.md
similarity index 100%
rename from docs/3.api/5.commands/build.md
rename to docs/5.api/5.commands/build.md
diff --git a/docs/3.api/5.commands/cleanup.md b/docs/5.api/5.commands/cleanup.md
similarity index 100%
rename from docs/3.api/5.commands/cleanup.md
rename to docs/5.api/5.commands/cleanup.md
diff --git a/docs/3.api/5.commands/dev.md b/docs/5.api/5.commands/dev.md
similarity index 100%
rename from docs/3.api/5.commands/dev.md
rename to docs/5.api/5.commands/dev.md
diff --git a/docs/3.api/5.commands/devtools.md b/docs/5.api/5.commands/devtools.md
similarity index 100%
rename from docs/3.api/5.commands/devtools.md
rename to docs/5.api/5.commands/devtools.md
diff --git a/docs/3.api/5.commands/generate.md b/docs/5.api/5.commands/generate.md
similarity index 100%
rename from docs/3.api/5.commands/generate.md
rename to docs/5.api/5.commands/generate.md
diff --git a/docs/3.api/5.commands/info.md b/docs/5.api/5.commands/info.md
similarity index 100%
rename from docs/3.api/5.commands/info.md
rename to docs/5.api/5.commands/info.md
diff --git a/docs/3.api/5.commands/init.md b/docs/5.api/5.commands/init.md
similarity index 100%
rename from docs/3.api/5.commands/init.md
rename to docs/5.api/5.commands/init.md
diff --git a/docs/3.api/5.commands/prepare.md b/docs/5.api/5.commands/prepare.md
similarity index 100%
rename from docs/3.api/5.commands/prepare.md
rename to docs/5.api/5.commands/prepare.md
diff --git a/docs/3.api/5.commands/preview.md b/docs/5.api/5.commands/preview.md
similarity index 100%
rename from docs/3.api/5.commands/preview.md
rename to docs/5.api/5.commands/preview.md
diff --git a/docs/3.api/5.commands/typecheck.md b/docs/5.api/5.commands/typecheck.md
similarity index 100%
rename from docs/3.api/5.commands/typecheck.md
rename to docs/5.api/5.commands/typecheck.md
diff --git a/docs/3.api/5.commands/upgrade.md b/docs/5.api/5.commands/upgrade.md
similarity index 100%
rename from docs/3.api/5.commands/upgrade.md
rename to docs/5.api/5.commands/upgrade.md
diff --git a/docs/3.api/6.configuration/_dir.yml b/docs/5.api/6.configuration/_dir.yml
similarity index 100%
rename from docs/3.api/6.configuration/_dir.yml
rename to docs/5.api/6.configuration/_dir.yml
diff --git a/docs/3.api/6.configuration/nuxt-config.md b/docs/5.api/6.configuration/nuxt-config.md
similarity index 100%
rename from docs/3.api/6.configuration/nuxt-config.md
rename to docs/5.api/6.configuration/nuxt-config.md
diff --git a/docs/5.api/_dir.yml b/docs/5.api/_dir.yml
new file mode 100644
index 0000000000..79c43cc03c
--- /dev/null
+++ b/docs/5.api/_dir.yml
@@ -0,0 +1,3 @@
+title: API Reference
+image: '/socials/api.jpg'
+navigation.icon: heroicons:code-bracket-20-solid
diff --git a/docs/3.api/index.md b/docs/5.api/index.md
similarity index 100%
rename from docs/3.api/index.md
rename to docs/5.api/index.md
diff --git a/docs/5.community/1.nuxt-community.md b/docs/5.community/1.nuxt-community.md
deleted file mode 100644
index a63868067d..0000000000
--- a/docs/5.community/1.nuxt-community.md
+++ /dev/null
@@ -1,210 +0,0 @@
----
-navigation.icon: ph:users-bold
----
-
-
-
-::docs-hero
----
-image:
- path: '/assets/docs/getting-started/nuxt-community/nuxt-community'
- width: '437'
- height: '236'
- format: 'png'
----
-#title
-Nuxt Community
-#description
-Nuxt would not be what it is today without its community of maintainers, contributors and users.
-#extra
-:newsletter-form
-::
-
-::community-section
-#title
-The journey of an [Open Source Project]{.text-transparent .bg-clip-text .bg-gradient-to-r .from-green-400 .to-teal-400}
-#description
-The development of Nuxt and its ecosystem is led by an international team. Our committed team and community work every day to move Nuxt forward.
-#extra
- ::docs-community-journey-section{.dark:bg-gray-900}
- ---
- fontSizeClass: 'text-2xl'
- ---
- #extraTitle
- Since the creation of Nuxt 3
- ::card-list
- ---
- cardListClass: 'grid grid-cols-1 gap-1 sm:gap-8 sm:grid-cols-2 lg:grid-cols-4 border-gray-200 dark:border-gray-800 rounded-xl'
- backgroundImage:
- path: '/assets/docs/getting-started/nuxt-community/map-nuxters'
- width: '582'
- height: '187'
- format: 'png'
- ---
- :::card-item
- ---
- gradientBorder: false
- titleClass: 'text-3xl font-semibold sm:text-5xl u-text-gray-900 mb-2 mt-2'
- descriptionClass: 'u-text-gray-500 text-lg font-medium'
- backgroundColor: 'bg-transparent'
- border: false
- contentClass: 'gap-y-0'
- ---
- #title
- 60M
- #description
- npm downloads
- :::
- :::card-item
- ---
- gradientBorder: false
- titleClass: 'text-3xl font-semibold sm:text-5xl u-text-gray-900 mb-2 mt-2'
- descriptionClass: 'u-text-gray-500 text-lg font-medium'
- border: false
- backgroundColor: 'bg-transparent'
- contentClass: 'gap-y-0'
- ---
- #title
- 75K
- #description
- Stars
- :::
- :::card-item
- ---
- gradientBorder: false
- titleClass: 'text-3xl font-semibold sm:text-5xl u-text-gray-900 mb-2 mt-2'
- descriptionClass: 'u-text-gray-500 text-lg font-medium'
- border: false
- backgroundColor: 'bg-transparent'
- contentClass: 'gap-y-0'
- ---
- #title
- 330
- #description
- Contributors
- :::
- :::card-item
- ---
- gradientBorder: false
- titleClass: 'text-3xl font-semibold sm:text-5xl u-text-gray-900 mb-2 mt-2'
- descriptionClass: 'u-text-gray-500 text-lg font-medium'
- backgroundColor: 'bg-transparent'
- border: false
- contentClass: 'gap-y-0'
- ---
- #title
- 1K
- #description
- Forks
- :::
- ::
- ::
-::
-
-::community-section
-#title
-From users to [Contributors]{.text-transparent .bg-clip-text .bg-gradient-to-r .from-green-400 .to-teal-400}
-#description
-From contributors to advocates, the community is made of members with different horizons and skills. We are happy to see new members every day and encourage anyone to help in any way (answering questions, giving a talk, creating modules and contributing to the core).
-#extra
- ::contributors-card
- #title
- Sharing is caring
- #default
- 1. Hundreds of conferences, meetups and workshop all around the world since the creation of Nuxt.
- 2. An active contribution on the framework but also on the different Nuxt open source projects: bug fixes, pull requests...
- 3. A lovely and precious help to teach you, help you and nuxtify the world.
- ::
-::
-
-
-::community-section
-#title
-Join the [journey]{.text-transparent .bg-clip-text .bg-gradient-to-r .from-green-400 .to-teal-400}
-#description
-From user to contributor, these guides will help you get the best out of Nuxt.
-#extra
- ::card-list
- ---
- cardListClass: 'grid grid-cols-1 pt-6 gap-y-4 sm:gap-y-0 sm:grid-cols-2 border-gray-200 dark:border-gray-800 rounded-lg overflow-hidden'
- ---
- ::card-item{ .pl-1 .border .dark:bg-gray-900 .dark:border-gray-800 .sm:rounded-bl-none .sm:rounded-r-none .sm:rounded-br-none .sm:rounded-tl-lg }
- ---
- border: false
- rounded: 'sm'
- ringClass: 'ring-0'
- gradientBorder: false
- descriptionClass: 'w-full sm:w-2/3'
- backgroundImageClass: 'hidden sm:block absolute bottom-0 right-0'
- backgroundImage:
- path: '/assets/docs/getting-started/nuxt-community/community-contribute'
- width: '88'
- height: '88'
- format: 'png'
- titleClass: 'text-base font-semibold u-text-gray-900'
- ---
- #title
- [How to contribute?](/docs/community/contribution)
- #description
- Nuxt is a community project - and so we love contributions of all kinds! ❤️
- ::
- ::card-item{ .rounded-md .dark:bg-gray-900 .border .dark:border-gray-800 .sm:rounded-l-none .sm:rounded-br-none .sm:rounded-tr-lg }
- ---
- border: false
- ringClass: 'ring-0'
- gradientBorder: false
- descriptionClass: 'w-full sm:w-2/3'
- backgroundImageClass: 'hidden sm:block absolute bottom-0 right-0'
- backgroundImage:
- path: '/assets/docs/getting-started/nuxt-community/roadmap'
- width: '88'
- height: '88'
- format: 'png'
- titleClass: 'text-base font-semibold u-text-gray-900'
- ---
- #title
- [Discover our roadmap](/docs/community/roadmap)
- #description
- Nuxt is constantly evolving, with new features and modules being added all the time.
- ::
- ::card-item{ .pl-1 .dark:bg-gray-900 .border .dark:border-gray-800 .sm:rounded-tl-none .sm:rounded-r-none .sm:rounded-bl-lg }
- ---
- ringClass: 'ring-0'
- border: false
- rounded: 'sm'
- gradientBorder: false
- descriptionClass: 'w-full sm:w-2/3'
- backgroundImageClass: 'hidden sm:block absolute bottom-0 right-0'
- backgroundImage:
- path: '/assets/docs/getting-started/nuxt-community/bugs'
- width: '88'
- height: '88'
- format: 'png'
- titleClass: 'text-base font-semibold u-text-gray-900'
- ---
- #title
- [Reporting Bugs](/docs/community/reporting-bugs)
- #description
- One of the most valuable roles in open source is taking the time to report bugs helpfully.
- ::
- ::card-item{ .rounded-md .dark:bg-gray-900 .border .dark:border-gray-800 .sm:rounded-l-none .sm:rounded-br-lg .sm:rounded-tr-none}
- ---
- ringClass: 'ring-0'
- border: false
- gradientBorder: false
- descriptionClass: 'w-full sm:w-2/3'
- backgroundImageClass: 'hidden sm:block absolute bottom-0 right-0'
- backgroundImage:
- path: '/assets/docs/getting-started/nuxt-community/help'
- width: '88'
- height: '88'
- format: 'png'
- titleClass: 'text-base font-semibold u-text-gray-900'
- ---
- #title
- [Getting Help](/docs/community/getting-help)
- #description
- We're a friendly community of developers and we'd love to help you!
- ::
- ::
-::
diff --git a/docs/5.community/_contributors.yml b/docs/5.community/_contributors.yml
deleted file mode 100644
index 645dba9d65..0000000000
--- a/docs/5.community/_contributors.yml
+++ /dev/null
@@ -1,4 +0,0 @@
-contributors:
- name: ''
- link: ''
-
diff --git a/docs/5.community/_dir.yml b/docs/5.community/_dir.yml
deleted file mode 100644
index 161f5e2271..0000000000
--- a/docs/5.community/_dir.yml
+++ /dev/null
@@ -1 +0,0 @@
-image: '/socials/community.jpg'
diff --git a/docs/2.guide/3.going-further/1.internals.md b/docs/6.going-further/1.internals.md
similarity index 100%
rename from docs/2.guide/3.going-further/1.internals.md
rename to docs/6.going-further/1.internals.md
diff --git a/docs/2.guide/3.going-further/10.runtime-config.md b/docs/6.going-further/10.runtime-config.md
similarity index 100%
rename from docs/2.guide/3.going-further/10.runtime-config.md
rename to docs/6.going-further/10.runtime-config.md
diff --git a/docs/2.guide/3.going-further/11.edge-channel.md b/docs/6.going-further/11.edge-channel.md
similarity index 100%
rename from docs/2.guide/3.going-further/11.edge-channel.md
rename to docs/6.going-further/11.edge-channel.md
diff --git a/docs/2.guide/3.going-further/2.hooks.md b/docs/6.going-further/2.hooks.md
similarity index 100%
rename from docs/2.guide/3.going-further/2.hooks.md
rename to docs/6.going-further/2.hooks.md
diff --git a/docs/2.guide/3.going-further/3.modules.md b/docs/6.going-further/3.modules.md
similarity index 100%
rename from docs/2.guide/3.going-further/3.modules.md
rename to docs/6.going-further/3.modules.md
diff --git a/docs/2.guide/3.going-further/4.kit.md b/docs/6.going-further/4.kit.md
similarity index 100%
rename from docs/2.guide/3.going-further/4.kit.md
rename to docs/6.going-further/4.kit.md
diff --git a/docs/2.guide/3.going-further/6.nuxt-app.md b/docs/6.going-further/6.nuxt-app.md
similarity index 100%
rename from docs/2.guide/3.going-further/6.nuxt-app.md
rename to docs/6.going-further/6.nuxt-app.md
diff --git a/docs/2.guide/3.going-further/7.layers.md b/docs/6.going-further/7.layers.md
similarity index 100%
rename from docs/2.guide/3.going-further/7.layers.md
rename to docs/6.going-further/7.layers.md
diff --git a/docs/2.guide/3.going-further/8.custom-routing.md b/docs/6.going-further/8.custom-routing.md
similarity index 100%
rename from docs/2.guide/3.going-further/8.custom-routing.md
rename to docs/6.going-further/8.custom-routing.md
diff --git a/docs/2.guide/3.going-further/_dir.yml b/docs/6.going-further/_dir.yml
similarity index 100%
rename from docs/2.guide/3.going-further/_dir.yml
rename to docs/6.going-further/_dir.yml
diff --git a/docs/2.guide/3.going-further/index.md b/docs/6.going-further/index.md
similarity index 100%
rename from docs/2.guide/3.going-further/index.md
rename to docs/6.going-further/index.md
diff --git a/docs/5.community/2.getting-help.md b/docs/7.community/2.getting-help.md
similarity index 100%
rename from docs/5.community/2.getting-help.md
rename to docs/7.community/2.getting-help.md
diff --git a/docs/5.community/3.reporting-bugs.md b/docs/7.community/3.reporting-bugs.md
similarity index 100%
rename from docs/5.community/3.reporting-bugs.md
rename to docs/7.community/3.reporting-bugs.md
diff --git a/docs/5.community/4.contribution.md b/docs/7.community/4.contribution.md
similarity index 100%
rename from docs/5.community/4.contribution.md
rename to docs/7.community/4.contribution.md
diff --git a/docs/5.community/5.framework-contribution.md b/docs/7.community/5.framework-contribution.md
similarity index 100%
rename from docs/5.community/5.framework-contribution.md
rename to docs/7.community/5.framework-contribution.md
diff --git a/docs/5.community/6.roadmap.md b/docs/7.community/6.roadmap.md
similarity index 100%
rename from docs/5.community/6.roadmap.md
rename to docs/7.community/6.roadmap.md
diff --git a/docs/5.community/7.changelog.md b/docs/7.community/7.changelog.md
similarity index 100%
rename from docs/5.community/7.changelog.md
rename to docs/7.community/7.changelog.md
diff --git a/docs/7.community/_dir.yml b/docs/7.community/_dir.yml
new file mode 100644
index 0000000000..0dc12483b5
--- /dev/null
+++ b/docs/7.community/_dir.yml
@@ -0,0 +1,2 @@
+image: '/socials/community.jpg'
+navigation.icon: heroicons:globe-alt
diff --git a/docs/5.community/index.md b/docs/7.community/index.md
similarity index 100%
rename from docs/5.community/index.md
rename to docs/7.community/index.md
diff --git a/docs/7.migration/1.overview.md b/docs/8.migration/1.overview.md
similarity index 71%
rename from docs/7.migration/1.overview.md
rename to docs/8.migration/1.overview.md
index 2a5d2558a9..129246092d 100644
--- a/docs/7.migration/1.overview.md
+++ b/docs/8.migration/1.overview.md
@@ -1,15 +1,13 @@
-# Overview
+---
+navigation.title: 'Overview'
+---
+
+# Migration from Nuxt 2
Nuxt 3 is a complete rewrite of Nuxt 2, and also based on a new set of underlying technologies.
That means there will be significant changes when migrating a Nuxt 2 app to Nuxt 3, although you can expect migration to become more straightforward as we move toward a stable release.
-
-
::alert{type=info}
This migration guide is under progress to align with the development of Nuxt 3.
::
diff --git a/docs/7.migration/10.bundling.md b/docs/8.migration/10.bundling.md
similarity index 100%
rename from docs/7.migration/10.bundling.md
rename to docs/8.migration/10.bundling.md
diff --git a/docs/7.migration/11.server.md b/docs/8.migration/11.server.md
similarity index 100%
rename from docs/7.migration/11.server.md
rename to docs/8.migration/11.server.md
diff --git a/docs/7.migration/2.configuration.md b/docs/8.migration/2.configuration.md
similarity index 100%
rename from docs/7.migration/2.configuration.md
rename to docs/8.migration/2.configuration.md
diff --git a/docs/7.migration/20.module-authors.md b/docs/8.migration/20.module-authors.md
similarity index 100%
rename from docs/7.migration/20.module-authors.md
rename to docs/8.migration/20.module-authors.md
diff --git a/docs/7.migration/3.auto-imports.md b/docs/8.migration/3.auto-imports.md
similarity index 100%
rename from docs/7.migration/3.auto-imports.md
rename to docs/8.migration/3.auto-imports.md
diff --git a/docs/7.migration/4.meta.md b/docs/8.migration/4.meta.md
similarity index 100%
rename from docs/7.migration/4.meta.md
rename to docs/8.migration/4.meta.md
diff --git a/docs/7.migration/5.plugins-and-middleware.md b/docs/8.migration/5.plugins-and-middleware.md
similarity index 100%
rename from docs/7.migration/5.plugins-and-middleware.md
rename to docs/8.migration/5.plugins-and-middleware.md
diff --git a/docs/7.migration/6.pages-and-layouts.md b/docs/8.migration/6.pages-and-layouts.md
similarity index 100%
rename from docs/7.migration/6.pages-and-layouts.md
rename to docs/8.migration/6.pages-and-layouts.md
diff --git a/docs/7.migration/7.component-options.md b/docs/8.migration/7.component-options.md
similarity index 100%
rename from docs/7.migration/7.component-options.md
rename to docs/8.migration/7.component-options.md
diff --git a/docs/7.migration/8.runtime-config.md b/docs/8.migration/8.runtime-config.md
similarity index 100%
rename from docs/7.migration/8.runtime-config.md
rename to docs/8.migration/8.runtime-config.md
diff --git a/docs/7.migration/_dir.yml b/docs/8.migration/_dir.yml
similarity index 60%
rename from docs/7.migration/_dir.yml
rename to docs/8.migration/_dir.yml
index 04f0d8d1ea..0c8fca2bd4 100644
--- a/docs/7.migration/_dir.yml
+++ b/docs/8.migration/_dir.yml
@@ -1,2 +1,3 @@
titleTemplate: 'Migrate to Nuxt 3: %s'
image: '/socials/guide.jpg'
+navigation.icon: heroicons:arrow-up-circle
diff --git a/docs/6.bridge/1.overview.md b/docs/99.bridge/1.overview.md
similarity index 100%
rename from docs/6.bridge/1.overview.md
rename to docs/99.bridge/1.overview.md
diff --git a/docs/6.bridge/2.bridge-composition-api.md b/docs/99.bridge/2.bridge-composition-api.md
similarity index 100%
rename from docs/6.bridge/2.bridge-composition-api.md
rename to docs/99.bridge/2.bridge-composition-api.md
diff --git a/docs/6.bridge/_dir.yml b/docs/99.bridge/_dir.yml
similarity index 100%
rename from docs/6.bridge/_dir.yml
rename to docs/99.bridge/_dir.yml