nuxt

SKILL.md

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-09-25.

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

Configuration
nuxt.config.ts, app.config.ts, aliases, Nuxt 5 defaults, jiti removal, experimental
core-config

CLI Commands
Dev server, build, generate, preview, and utility commands
core-cli

Routing
File-based routing, case-sensitive + typed routes, named views, layout props, middleware
core-routing

Data Fetching
useFetch, useAsyncData, $fetch, typed routes, createUseFetch factories, caching
core-data-fetching

Modules
Creating and using Nuxt modules, Nuxt Kit utilities
core-modules

Deployment
Platform-agnostic deployment with Nitro, Vercel, Netlify, Cloudflare
core-deployment