Nuxt docs, chapter by chapter

Train

Nuxt docs, chapter by chapter

How to use this section to learn the official Nuxt 4 documentation thoroughly — getting started, concepts, every directory, going further, and the full API reference — and quiz yourself on it.
Nuxt 4 docsNuxt API referenceNuxt docs as Markdown (llms.txt)

The Building Nuxt apps section explains how to build with Nuxt at senior depth. This section is the reference layer: the official Nuxt 4 documentation, chapter by chapter, in the docs' own order, distilled to the statements an interviewer can check. Every page links to the chapters it summarises. Read a digest, open the chapters, then train the section's questions, which are written at the level of the docs.

Snapshot: Nuxt 4.5.2 is the latest release (5 August 2026). The docs describe some things that are landing in 4.6 or Nuxt 5 (nuxt/server imports, server builders); those are marked as such here.

Know

  • The documentation has four parts. Getting Started (installation through upgrade), the Guide (Concepts, Directory Structure, Going Further, Recipes, Best Practices, Module Author Guide, AI), the API (Components, Composables, Utils, Commands, Nuxt Kit, Advanced, Configuration), and Community. There are also migration guides (Nuxt 2 → 3, Bridge) and a catalogue of error codes (NUXT_E…).
  • Every docs page is available as Markdown by appending .md to its URL or via https://nuxt.com/llms.txt, and there is an official MCP server at https://nuxt.com/mcp. Mentioning this shows you know how to work with the docs in 2026 tooling.
  • Version badges matter. The docs tag features with the minor that introduced them (v3.12, v3.14, v4.3, v4.4). Knowing the recent ones (useAnnouncer 4.4.2, clearNuxtState({ reset }) 4.4, View Transition types 4.4, disabling modules and the server alias 4.3) signals that you read release notes.
  • Kit and module authoring are covered by the Module authoring and Layers sections; this section only maps them.

How the pages fit

PageDocs chapters
Getting started IInstallation, Configuration, Views, Assets, Styling
Getting started IIRouting, SEO and Meta, Transitions, Data Fetching, State Management, Error Handling
Getting started IIIServer, Layers, Prerendering, Deployment, Testing, Upgrade Guide
ConceptsAuto-imports, Nuxt Lifecycle, Vue.js Development, Rendering Modes, Server Components, Server Engine, Modules, ES Modules, TypeScript, Code Style
Directory structure — app/assets, components, composables, layouts, middleware, pages, plugins, utils, app.vue, app.config.ts, error.vue
Directory structure — rootcontent, layers, modules, public, server, shared, test, .env, .gitignore, .nuxt, .nuxtignore, .nuxtrc, .output, nuxt.config.ts, package.json, tsconfig.json
Going furtherExperimental Features, Features, How Nuxt Works, Runtime Config, Nightly channel, Lifecycle Hooks, Layers, NuxtApp, Debugging, Custom Events, Server Imports, Kit, Builders
Recipes and best practicesCustom Routing, Custom useFetch, Mostly-Static Sites, Sessions and Authentication, Vite Plugins; Accessibility, Dev Containers, Hydration, Performance, Plugins; llms.txt, MCP
API — componentsEvery built-in component and its props
API — composablesEvery composable, its signature and side
API — utilsEvery utility function
API — commands, config, advancedThe CLI, nuxt.config keys, hooks, import.meta, error codes

How to study it

Read the digests in order once, opening the linked chapters as you go and marking pages as read. Then train this section's questions in "Unseen first" mode; they are deliberately fact-level so that the vocabulary becomes automatic. The Building Nuxt apps questions then test whether you can use the facts.

Gotcha· 3.x pages in search results

Search engines still rank nuxt.com/docs/3.x/... and old blog posts highly. Nuxt 4 changed defaults (app/ directory, data defaulting to undefined, shallow data fetching, compatibilityDate) and every digest here is written against /docs/4.x/. Check the URL before trusting a snippet.

Exercise

Exercise
  • Open https://nuxt.com/llms.txt, count the pages under each part of the docs, and note which ones you have never opened.
  • Append .md to any docs URL and read it raw; then configure the Nuxt MCP server in your editor and ask it one question about useAsyncData.

Be able to say

Be able to say· How well do you know the Nuxt documentation?

"Well enough to navigate it from memory: Getting Started from installation to the upgrade guide, the Guide's concepts and directory structure, the Going Further chapters on runtime config, hooks, layers and internals, the recipes, and the API reference for components, composables, utils and the CLI. I know which features carry a recent version badge, I read the docs as Markdown or through the Nuxt MCP server when I need precision, and I check the 4.x URL before I trust a snippet, because the 3.x defaults differ."

Pages in this section

  1. 01Getting started I — installation, configuration, views, assets, stylingThe first Getting Started chapters — creating a project, nuxt.config with environment overrides, runtimeConfig versus app.config, external config files, app.vue/pages/layouts, the public and assets directories, and every way to load styles.
  2. 02Getting started II — routing, SEO, transitions, data, state, errorsThe middle Getting Started chapters — Routing, SEO and Meta, Transitions, Data Fetching, State Management and Error Handling — reduced to the statements, options and defaults the docs make.
  3. 03Getting started III — server, layers, prerendering, deployment, testing, upgradeThe last Getting Started chapters — the Nitro server, layers and their priority, crawl-based prerendering and payload extraction, deployment targets and presets, the @nuxt/test-utils testing setup, and the upgrade guide's list of Nuxt 4 changes.
  4. 04ConceptsThe Guide's Concepts chapters — Auto-imports, Nuxt Lifecycle, Vue.js Development (including Vapor interop), Rendering Modes, Server Components, Server Engine, Modules, ES Modules, TypeScript and Code Style — as statements to remember.
  5. 05Directory structure — app/What the docs state for every entry under app/ — assets, components, composables, layouts, middleware, pages, plugins, utils, app.vue, app.config.ts, error.vue and router.options.ts — including scanning rules, naming and ordering.
  6. 06Directory structure — project rootThe root-level entries the docs describe — content, layers, modules, public, server, shared, test, .env, .gitignore, .nuxt, .nuxtignore, .nuxtrc, .output, nuxt.config.ts, package.json and tsconfig.json — and the rule each one carries.
  7. 07Going furtherThe Going Further chapters — Experimental Features and their flags, Features and the future namespace, How Nuxt Works, Runtime Config, the Nightly Release Channel, Lifecycle Hooks, Layers, NuxtApp, Debugging, Custom Events, Server Imports, Kit and Builders.
  8. 08Recipes, best practices and AI docsThe Guide's Recipes (Custom Routing, Custom useFetch, Mostly-Static Sites, Sessions and Authentication, Vite Plugins), the Best Practices pages (Accessibility, Dev Containers, Hydration, Performance, Plugins) and the AI pages (llms.txt, MCP server).
  9. 09API — componentsEvery built-in Nuxt component from the API reference with its props, slots and rules — ClientOnly, DevOnly, NuxtClientFallback, NuxtPage, NuxtLayout, NuxtLink, NuxtLoadingIndicator, NuxtErrorBoundary, NuxtIsland, NuxtRouteAnnouncer, NuxtAnnouncer, NuxtTime, NuxtImg, NuxtPicture, NuxtWelcome and Teleport.
  10. 10API — composablesEvery composable in the Nuxt API reference with its purpose, signature shape, side and version — from useAsyncData and useFetch to createUseFetch, useAnnouncer, useLayout, useRuntimeHook, onPrehydrate, useHydration, usePreviewMode and the request/response helpers.
  11. 11API — utilsEvery utility in the Nuxt API reference — the define* macros, navigation helpers, error helpers, data and state cache helpers, preload and prefetch helpers, lifecycle utilities and the server-side response helpers.
  12. 12API — commands, configuration, advancedThe Nuxt CLI and every command with its notable flags, the top-level keys of nuxt.config, the three hook families, the import.meta flags, and the error-code catalogue.

Your notes

Open in Notes

Nothing yet. Notes filed here show up on every page of this section.

API reference map

The Vue API reference as a quiz sheet — application API and config, general helpers, every built-in directive with its modifiers, special elements and attributes, the SFC spec and script setup rules, reactivity utilities, compile-time flags and the SSR API.

Getting started I — installation, configuration, views, assets, styling

The first Getting Started chapters — creating a project, nuxt.config with environment overrides, runtimeConfig versus app.config, external config files, app.vue/pages/layouts, the public and assets directories, and every way to load styles.