nitro

该 Skill 是 Nitro v3 的文档型参考，覆盖文件路由、路由规则、缓存、KV 存储、运行时配置、任务、WebSocket/SSE、数据库、OpenAPI 与多平台部署预设，并说明 v2 到 v3 的迁移差异；未包含可执行脚本或依赖清单。

onmax

热度 0.00

最近更新 2026-10-19 02:47:26

分类：开发依赖：纯提示词应用场景：代码生成 / API 集成 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add onmax/nuxt-skills/nitro

Metadata

name: nitro
description: Nitro is the framework-agnostic server toolkit (powering Nuxt) for building and deploying web servers anywhere. Use when working with nitro.config, server routes/event handlers, route rules, caching, storage, tasks, websockets, or deploying to Node/Bun/Deno/Cloudflare/Vercel.
metadata: {"author":"Anthony Fu","version":"2026.9.25","source":"Generated from https://github.com/nitrojs/nitro, scripts located at https://github.com/antfu/skills"}

The skill is based on Nitro v3 (beta, 3.0.260903), generated at 2026-09-25.

Nitro is a framework-agnostic, deployment-agnostic server toolkit powered by H3 v2, unstorage, and Vite/Rolldown/Rollup. It powers Nuxt and works standalone. From one codebase it builds optimized output for Node.js, Bun, Deno, Cloudflare, Vercel, Netlify, and more.

Key capabilities:

Filesystem routing with H3 v2 event handlers, dynamic params, and method suffixes.
Route rules for declarative caching, headers, redirects, proxying, and CORS.
Caching layer (cached handlers/functions, SWR) on top of the unstorage KV layer.
Runtime config overridable via NITRO_* env vars.
Tasks (on-demand + scheduled/cron), WebSockets/SSE, a SQL database layer, and OpenAPI auto-docs.
Plugins & lifecycle hooks, custom renderer/server entry, and portable deployment presets.

Key v3 changes (vs. nitropack v2): the package is renamed nitropack → nitro with H3 v2 (web-standard Request/Response); auto-imports are removed (import everything explicitly); directory scanning is opt-in via serverDir; useStorage → useKV (nitro/kv) and the storage config option → kv; cache swr now defaults to false. If unsure about v2-vs-v3 APIs, read advanced-migration first.

Core

Topic	Description	Reference
Routing	File-based routes, `defineHandler`, params, middleware, route rules, errors	core-routing
Configuration	`nitro.config.ts`, `defineConfig`, key options, runtime config	core-configuration
Storage	unstorage KV, mount points, drivers, dynamic mounts	core-storage
Cache	`defineCachedHandler`, `defineCachedFunction`, SWR, invalidation	core-cache
Assets	Public assets, compression, server assets via storage	core-assets
Rendering	Renderer (HTML/SSR), server entry, framework integration	core-rendering

Features

Topic	Description	Reference
Plugins & Hooks	`definePlugin`, runtime lifecycle hooks, error capture	features-plugins
Tasks	On-demand & scheduled (cron) tasks, `runTask`	features-tasks
WebSocket & SSE	`defineWebSocketHandler`, pub/sub, namespaces, event streams	features-websocket
Database	Built-in SQL layer via db0, `useDatabase`, connectors	features-database
OpenAPI	Auto spec from `defineRouteMeta`, Scalar/Swagger UIs	features-openapi

Advanced / Deployment

Topic	Description	Reference
Deployment Presets	Runtimes & providers, compatibility dates, platform integration	deploy-presets
v2 → v3 Migration	Package rename, `nitro/*` imports, H3 v2 API, preset changes	advanced-migration