antfu / skills

nuxt

Nuxt full-stack Vue framework guidance for SSR, auto-imports, file-based routing, and server routes.

Install

npx skills add https://github.com/antfu/skills --skill nuxt

metadata: author: Anthony Fu version: "2026.11.5" source: Generated from https://github.com/nuxt/nuxt, scripts located at https://github.com/antfu/skills

Nuxt is a full-stack Vue framework that provides server-side rendering, file-based routing, auto-imports, and a powerful module system. It uses Nitro as its server engine for universal deployment across Node.js, serverless, and edge platforms.

The skill is based on Nuxt 5.x (5.0.0-0), generated at 2026-11-05.

Directory layout: the default srcDir is app/ — Vue app code (app.vue, components/, composables/, pages/, etc.) lives under app/, while server/, shared/, public/, modules/, layers/ and nuxt.config.ts stay at the project root. The ~/@ aliases point at app/; use ~~/@@ for the root.

Nuxt 5 note: Nuxt 5 makes many former experimental flags the default. The biggest shifts for agents: server code moves to Nitro v3 (h3 v2, Web-standard Request/Response), server utilities import from nuxt/server and are no longer auto-imported by default, $fetch/useFetch are typed from generated route types, routing is case-sensitive and typed by default, and the bundler is Vite 8 (Rolldown). Nuxt 5 requires Node 22.19/24.11+. A Nitro v2 compatibility layer (nitroLegacy) keeps older server code building during migration. See individual references for details.

Core

Topic	Description	Reference
Directory Structure	Nuxt 4 `app/` srcDir, `shared/`, aliases, conventions	core-directory-structure [blocked]
Configuration	nuxt.config.ts, app.config.ts, aliases, Nuxt 5 defaults, jiti removal, experimental	core-config [blocked]
CLI Commands	Dev server, build, generate, preview, and utility commands	core-cli [blocked]
Routing	File-based routing, case-sensitive + typed routes, named views, layout props, middleware	core-routing [blocked]
Data Fetching	useFetch, useAsyncData, $fetch, typed routes, createUseFetch factories, caching	core-data-fetching [blocked]
Modules	Creating and using Nuxt modules, Nuxt Kit utilities	core-modules [blocked]
Deployment	Platform-agnostic deployment with Nitro, Vercel, Netlify, Cloudflare	core-deployment [blocked]

Features

Topic	Description	Reference
Composables Auto-imports	Vue/Nuxt composables, custom composables, `shared/`, useAnnouncer	features-composables [blocked]
Components Auto-imports	Component naming, lazy loading, hydration strategies	features-components-autoimport [blocked]
Built-in Components	NuxtLink, NuxtPage, NuxtLayout, NuxtAnnouncer, ClientOnly, and more	features-components [blocked]
State Management	useState composable, SSR-friendly state, Pinia integration	features-state [blocked]
Server Routes	API routes, `nuxt/server` imports, Nitro v3 (h3 v2), sessions, middleware	features-server [blocked]

Rendering

Topic	Description	Reference
Rendering Modes	Universal (SSR), client-side (SPA), hybrid rendering, route rules	rendering-modes [blocked]

Best Practices

Topic	Description	Reference
Data Fetching Patterns	Efficient fetching, caching, parallel requests, error handling	best-practices-data-fetching [blocked]
SSR & Hydration	Avoiding context leaks, hydration mismatches, composable patterns	best-practices-ssr [blocked]

Advanced

Topic	Description	Reference
Layers	Extending applications with reusable layers	advanced-layers [blocked]
Lifecycle Hooks	Build-time, runtime, and server hooks	advanced-hooks [blocked]
Module Authoring	Publishable modules with Nuxt Kit, keyed composables, dependencies	advanced-module-authoring [blocked]

Design engineering

Frameworks & libraries