nuxt
antfu/skills
Full-stack Vue framework with SSR, file-based routing, auto-imports, and Nitro server engine.
What is nuxt?
Nuxt is a full-stack Vue framework providing server-side rendering, file-based routing, auto-imports, and a powerful module system built on Nitro for universal deployment. Use it when building Nuxt applications, server routes, data fetching with useFetch, middleware, or hybrid rendering modes.
- File-based routing with case-sensitive, typed routes and layout support
- Server-side rendering (SSR) and hybrid rendering modes with Nitro v3 server engine
- Auto-imports for Vue/Nuxt composables and components with lazy-loading strategies
- Data fetching with useFetch, useAsyncData, and $fetch with typed route integration
- State management via useState composable and Pinia integration
- Module system for extending applications with reusable layers and custom modules
How to install nuxt
npx skills add https://github.com/antfu/skills --skill nuxt- Node.js 22.19 or 24.11+
- Nuxt 5.x project initialized
- Vite 8 (Rolldown) as bundler
How to use nuxt
- 1.Review the directory structure: app/ for Vue code, server/ and nuxt.config.ts at project root
- 2.Configure nuxt.config.ts for your rendering mode (SSR, SPA, or hybrid) and route rules
- 3.Create pages in app/pages/ using file-based routing; use app/components/ for auto-imported components
- 4.Define server routes in server/routes/ and use nuxt/server imports for server utilities
- 5.Use useFetch or useAsyncData in components for data fetching with typed routes
- 6.Build with `nuxi build` and deploy using Nitro's platform-agnostic deployment
Use cases
- Building full-stack web applications with server routes and API endpoints
- Creating universally deployable apps across Node.js, serverless, and edge platforms
- Developing SSR applications with automatic hydration and data fetching
- Building component libraries and reusable application layers
- Setting up type-safe data fetching with auto-generated route types
- Vue.js developers building full-stack applications
- Teams needing server-side rendering and SEO optimization
- Developers deploying to serverless or edge platforms
- Frontend engineers working on modular, scalable applications
nuxt FAQ
Nuxt 5 defaults many experimental flags: server code uses Nitro v3 (h3 v2, Web-standard Request/Response), server utilities require explicit `nuxt/server` imports, routing is case-sensitive and typed by default, and Vite 8 (Rolldown) is the bundler. Node 22.19+ is required.
Vue app code (pages, components, composables) goes in `app/`; server code, config, and modules stay at the project root. Use `~`/`@` aliases for `app/` and `~~`/`@@` for the root.
Use useFetch or useAsyncData in components; they handle SSR hydration automatically. For server-only logic, use server routes in `server/routes/` and call them via $fetch with typed routes.
Yes, use `nuxi generate` to pre-render routes. Configure route rules in nuxt.config.ts for hybrid rendering (some routes SSR, others prerendered).
Nitro supports Node.js, serverless (AWS Lambda, Vercel, Netlify), and edge platforms (Cloudflare, Deno). Build with `nuxi build` and deploy the output according to your platform.
Full instructions (SKILL.md)
Source of truth, from antfu/skills.
name: nuxt description: Nuxt full-stack Vue framework with SSR, auto-imports, and file-based routing. Use when working with Nuxt apps, server routes, useFetch, middleware, or hybrid rendering. metadata: author: Anthony Fu version: "2026.9.25" 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-09-25.
Directory layout: the default
srcDirisapp/— Vue app code (app.vue,components/,composables/,pages/, etc.) lives underapp/, whileserver/,shared/,public/,modules/,layers/andnuxt.config.tsstay at the project root. The~/@aliases point atapp/; 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 fromnuxt/serverand are no longer auto-imported by default,$fetch/useFetchare typed from generated route types, routing is case-sensitive and typed by default, and the bundler is Vite 8 (Rolldown). Nuxt 5 requires Node22.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 |
Features
| Topic | Description | Reference |
|---|---|---|
| Composables Auto-imports | Vue/Nuxt composables, custom composables, shared/, useAnnouncer | features-composables |
| Components Auto-imports | Component naming, lazy loading, hydration strategies | features-components-autoimport |
| Built-in Components | NuxtLink, NuxtPage, NuxtLayout, NuxtAnnouncer, ClientOnly, and more | features-components |
| State Management | useState composable, SSR-friendly state, Pinia integration | features-state |
| Server Routes | API routes, nuxt/server imports, Nitro v3 (h3 v2), sessions, middleware | features-server |
Rendering
| Topic | Description | Reference |
|---|---|---|
| Rendering Modes | Universal (SSR), client-side (SPA), hybrid rendering, route rules | rendering-modes |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| Data Fetching Patterns | Efficient fetching, caching, parallel requests, error handling | best-practices-data-fetching |
| SSR & Hydration | Avoiding context leaks, hydration mismatches, composable patterns | best-practices-ssr |
Advanced
| Topic | Description | Reference |
|---|---|---|
| Layers | Extending applications with reusable layers | advanced-layers |
| Lifecycle Hooks | Build-time, runtime, and server hooks | advanced-hooks |
| Module Authoring | Publishable modules with Nuxt Kit, keyed composables, dependencies | advanced-module-authoring |
Related skills
More from antfu/skills and the wider catalog.
pinia
Official Vue state management library with type-safe stores and extensible architecture.
pnpm
Fast, disk-space efficient Node.js package manager with strict dependency resolution and monorepo support.
slidev
Web-based slidedecks for developers with Markdown, Vue, code highlighting, and interactive features.
tsdown
Blazing-fast TypeScript/JavaScript library bundler powered by Rolldown with zero-config defaults.
turborepo
Monorepo build system with task caching, parallelization, and dependency graph optimization for JavaScript/TypeScript projects.
unocss
Instant atomic CSS engine—flexible Tailwind CSS superset with presets for icons, attributify, and more.