[{"data":1,"prerenderedAt":1625},["ShallowReactive",2],{"navigation":3,"-blog-v3-beta":393},[4,88,217,223,378,390],{"title":5,"path":6,"stem":7,"children":8,"icon":87},"","/docs","1.docs/1.index",[9,12,17,22,27,32,37,42,47,52,57,62,67,72,77,82],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-compass",{"title":13,"path":14,"stem":15,"icon":16},"Quick Start","/docs/quick-start","1.docs/2.quick-start","i-lucide-zap",{"title":18,"path":19,"stem":20,"icon":21},"Renderer","/docs/renderer","1.docs/4.renderer","ri:layout-masonry-line",{"title":23,"path":24,"stem":25,"icon":26},"Routing","/docs/routing","1.docs/5.routing","ri:direction-line",{"title":28,"path":29,"stem":30,"icon":31},"Assets","/docs/assets","1.docs/50.assets","ri:image-2-line",{"title":33,"path":34,"stem":35,"icon":36},"Configuration","/docs/configuration","1.docs/50.configuration","ri:settings-3-line",{"title":38,"path":39,"stem":40,"icon":41},"Database","/docs/database","1.docs/50.database","ri:database-2-line",{"title":43,"path":44,"stem":45,"icon":46},"Lifecycle","/docs/lifecycle","1.docs/50.lifecycle","i-lucide-layers",{"title":48,"path":49,"stem":50,"icon":51},"Plugins","/docs/plugins","1.docs/50.plugins","ri:plug-line",{"title":53,"path":54,"stem":55,"icon":56},"Tasks","/docs/tasks","1.docs/50.tasks","codicon:run-all",{"title":58,"path":59,"stem":60,"icon":61},"WebSocket","/docs/websocket","1.docs/50.websocket","ri:broadcast-fill",{"title":63,"path":64,"stem":65,"icon":66},"Server Entry","/docs/server-entry","1.docs/6.server-entry","ri:server-line",{"title":68,"path":69,"stem":70,"icon":71},"Cache","/docs/cache","1.docs/7.cache","ri:speed-line",{"title":73,"path":74,"stem":75,"icon":76},"KV Storage","/docs/storage","1.docs/8.storage","carbon:datastore",{"title":78,"path":79,"stem":80,"icon":81},"Migration Guide","/docs/migration","1.docs/99.migration","ri:arrow-right-up-line",{"title":83,"path":84,"stem":85,"icon":86},"Nightly Channel","/docs/nightly","1.docs/99.nightly","ri:moon-fill","i-lucide-book-open",{"title":89,"path":90,"stem":91,"children":92,"icon":94},"Deploy","/deploy","2.deploy/0.index",[93,95,116],{"title":89,"path":90,"stem":91,"icon":94},"ri:upload-cloud-2-line",{"title":96,"path":97,"stem":98,"children":99,"page":115},"Runtimes","/deploy/runtimes","2.deploy/10.runtimes",[100,105,110],{"title":101,"path":102,"stem":103,"icon":104},"Node.js","/deploy/runtimes/node","2.deploy/10.runtimes/1.node","akar-icons:node-fill",{"title":106,"path":107,"stem":108,"icon":109},"Bun","/deploy/runtimes/bun","2.deploy/10.runtimes/bun","simple-icons:bun",{"title":111,"path":112,"stem":113,"icon":114},"Deno","/deploy/runtimes/deno","2.deploy/10.runtimes/deno","simple-icons:deno",false,{"title":117,"path":118,"stem":119,"children":120,"page":115},"Providers","/deploy/providers","2.deploy/20.providers",[121,125,129,133,137,141,145,149,153,157,161,165,169,173,177,181,185,189,193,197,201,205,209,213],{"title":122,"path":123,"stem":124},"Alwaysdata","/deploy/providers/alwaysdata","2.deploy/20.providers/alwaysdata",{"title":126,"path":127,"stem":128},"AWS Lambda","/deploy/providers/aws","2.deploy/20.providers/aws",{"title":130,"path":131,"stem":132},"AWS Amplify","/deploy/providers/aws-amplify","2.deploy/20.providers/aws-amplify",{"title":134,"path":135,"stem":136},"Azure","/deploy/providers/azure","2.deploy/20.providers/azure",{"title":138,"path":139,"stem":140},"Cleavr","/deploy/providers/cleavr","2.deploy/20.providers/cleavr",{"title":142,"path":143,"stem":144},"Cloudflare","/deploy/providers/cloudflare","2.deploy/20.providers/cloudflare",{"title":146,"path":147,"stem":148},"Deno Deploy","/deploy/providers/deno-deploy","2.deploy/20.providers/deno-deploy",{"title":150,"path":151,"stem":152},"DigitalOcean","/deploy/providers/digitalocean","2.deploy/20.providers/digitalocean",{"title":154,"path":155,"stem":156},"Firebase","/deploy/providers/firebase","2.deploy/20.providers/firebase",{"title":158,"path":159,"stem":160},"Flightcontrol","/deploy/providers/flightcontrol","2.deploy/20.providers/flightcontrol",{"title":162,"path":163,"stem":164},"Genezio","/deploy/providers/genezio","2.deploy/20.providers/genezio",{"title":166,"path":167,"stem":168},"GitHub Pages","/deploy/providers/github-pages","2.deploy/20.providers/github-pages",{"title":170,"path":171,"stem":172},"GitLab Pages","/deploy/providers/gitlab-pages","2.deploy/20.providers/gitlab-pages",{"title":174,"path":175,"stem":176},"Heroku","/deploy/providers/heroku","2.deploy/20.providers/heroku",{"title":178,"path":179,"stem":180},"IIS","/deploy/providers/iis","2.deploy/20.providers/iis",{"title":182,"path":183,"stem":184},"Koyeb","/deploy/providers/koyeb","2.deploy/20.providers/koyeb",{"title":186,"path":187,"stem":188},"Netlify","/deploy/providers/netlify","2.deploy/20.providers/netlify",{"title":190,"path":191,"stem":192},"Platform.sh","/deploy/providers/platform-sh","2.deploy/20.providers/platform-sh",{"title":194,"path":195,"stem":196},"Render.com","/deploy/providers/render","2.deploy/20.providers/render",{"title":198,"path":199,"stem":200},"StormKit","/deploy/providers/stormkit","2.deploy/20.providers/stormkit",{"title":202,"path":203,"stem":204},"Vercel","/deploy/providers/vercel","2.deploy/20.providers/vercel",{"title":206,"path":207,"stem":208},"Zeabur","/deploy/providers/zeabur","2.deploy/20.providers/zeabur",{"title":210,"path":211,"stem":212},"Zephyr Cloud","/deploy/providers/zephyr","2.deploy/20.providers/zephyr",{"title":214,"path":215,"stem":216},"Zerops","/deploy/providers/zerops","2.deploy/20.providers/zerops",{"title":218,"path":219,"stem":220,"children":221,"icon":36},"Config","/config","3.config/0.index",[222],{"title":218,"path":219,"stem":220,"icon":36},{"title":224,"path":225,"stem":226,"children":227,"icon":229},"Examples","/examples","4.examples/0.index",[228,230,235,240,245,250,254,259,264,269,274,279,284,288,293,297,301,306,311,316,321,326,331,336,341,346,350,355,360,364,369,374],{"title":224,"path":225,"stem":226,"icon":229},"i-lucide-folder-code",{"title":231,"path":232,"stem":233,"icon":234},"API Routes","/examples/api-routes","4.examples/api-routes","i-lucide-route",{"title":236,"path":237,"stem":238,"icon":239},"Auto Imports","/examples/auto-imports","4.examples/auto-imports","i-lucide-import",{"title":241,"path":242,"stem":243,"icon":244},"Cached Handler","/examples/cached-handler","4.examples/cached-handler","i-lucide-clock",{"title":246,"path":247,"stem":248,"icon":249},"Custom Error Handler","/examples/custom-error-handler","4.examples/custom-error-handler","i-lucide-alert-circle",{"title":38,"path":251,"stem":252,"icon":253},"/examples/database","4.examples/database","i-lucide-database",{"title":255,"path":256,"stem":257,"icon":258},"Elysia","/examples/elysia","4.examples/elysia","i-skill-icons-elysia-dark",{"title":260,"path":261,"stem":262,"icon":263},"Express","/examples/express","4.examples/express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Fastify","/examples/fastify","4.examples/fastify","i-simple-icons-fastify",{"title":270,"path":271,"stem":272,"icon":273},"Hello World","/examples/hello-world","4.examples/hello-world","i-lucide-sparkles",{"title":275,"path":276,"stem":277,"icon":278},"Hono","/examples/hono","4.examples/hono","i-logos-hono",{"title":280,"path":281,"stem":282,"icon":283},"Import Alias","/examples/import-alias","4.examples/import-alias","i-lucide-at-sign",{"title":285,"path":286,"stem":287,"icon":46},"Middleware","/examples/middleware","4.examples/middleware",{"title":289,"path":290,"stem":291,"icon":292},"Mono JSX","/examples/mono-jsx","4.examples/mono-jsx","i-lucide-brackets",{"title":294,"path":295,"stem":296,"icon":292},"Nano JSX","/examples/nano-jsx","4.examples/nano-jsx",{"title":48,"path":298,"stem":299,"icon":300},"/examples/plugins","4.examples/plugins","i-lucide-plug",{"title":302,"path":303,"stem":304,"icon":305},"Custom Renderer","/examples/renderer","4.examples/renderer","i-lucide-code",{"title":307,"path":308,"stem":309,"icon":310},"Runtime Config","/examples/runtime-config","4.examples/runtime-config","i-lucide-settings",{"title":312,"path":313,"stem":314,"icon":315},"Server Fetch","/examples/server-fetch","4.examples/server-fetch","i-lucide-arrow-right-left",{"title":317,"path":318,"stem":319,"icon":320},"Shiki","/examples/shiki","4.examples/shiki","i-lucide-highlighter",{"title":322,"path":323,"stem":324,"icon":325},"Virtual Routes","/examples/virtual-routes","4.examples/virtual-routes","i-lucide-box",{"title":327,"path":328,"stem":329,"icon":330},"Vite Nitro Plugin","/examples/vite-nitro-plugin","4.examples/vite-nitro-plugin","i-logos-vitejs",{"title":332,"path":333,"stem":334,"icon":335},"Vite RSC","/examples/vite-rsc","4.examples/vite-rsc","i-logos-react",{"title":337,"path":338,"stem":339,"icon":340},"Vite SSR HTML","/examples/vite-ssr-html","4.examples/vite-ssr-html","i-logos-html-5",{"title":342,"path":343,"stem":344,"icon":345},"SSR with Preact","/examples/vite-ssr-preact","4.examples/vite-ssr-preact","i-logos-preact",{"title":347,"path":348,"stem":349,"icon":335},"SSR with React","/examples/vite-ssr-react","4.examples/vite-ssr-react",{"title":351,"path":352,"stem":353,"icon":354},"SSR with SolidJS","/examples/vite-ssr-solid","4.examples/vite-ssr-solid","i-logos-solidjs-icon",{"title":356,"path":357,"stem":358,"icon":359},"SSR with TanStack Router","/examples/vite-ssr-tsr-react","4.examples/vite-ssr-tsr-react","i-simple-icons-tanstack",{"title":361,"path":362,"stem":363,"icon":359},"SSR with TanStack Start","/examples/vite-ssr-tss-react","4.examples/vite-ssr-tss-react",{"title":365,"path":366,"stem":367,"icon":368},"SSR with Vue Router","/examples/vite-ssr-vue-router","4.examples/vite-ssr-vue-router","i-logos-vue",{"title":370,"path":371,"stem":372,"icon":373},"Vite + tRPC","/examples/vite-trpc","4.examples/vite-trpc","i-simple-icons-trpc",{"title":58,"path":375,"stem":376,"icon":377},"/examples/websocket","4.examples/websocket","i-lucide-radio",{"title":379,"path":380,"stem":381,"children":382},"Blog","/blog","9.blog",[383,386],{"title":379,"path":380,"stem":384,"icon":385},"9.blog/index","i-lucide-file-text",{"title":387,"path":388,"stem":389,"icon":385},"Nitro v3 Beta is here!","/blog/v3-beta","9.blog/1.v3-beta",{"title":5,"path":391,"stem":392},"/","index",{"id":394,"title":387,"body":395,"description":1613,"extension":1614,"meta":1615,"navigation":1622,"path":388,"seo":1623,"stem":389,"__hash__":1624},"content/9.blog/1.v3-beta.md",{"type":396,"value":397,"toc":1591,"icon":385},"minimark",[398,403,415,430,469,477,481,506,509,524,530,534,542,631,638,668,684,688,691,713,727,733,746,753,814,821,825,832,930,934,972,975,1060,1063,1140,1143,1158,1162,1169,1186,1190,1199,1259,1262,1266,1269,1336,1338,1341,1349,1406,1408,1412,1418,1431,1434,1438,1441,1444,1446,1450,1457,1465,1474,1478,1482,1486,1493,1497,1500,1557,1563,1566,1569,1587],[399,400,402],"h2",{"id":401},"a-brief-history","A Brief History",[404,405,406,407,414],"p",{},"Nitro started as the server engine for ",[408,409,413],"a",{"href":410,"rel":411},"https://nuxt.com",[412],"nofollow","Nuxt 3",", designed to solve a specific problem: deployment-agnostic servers.\nOver time, Nitro grew beyond Nuxt. It became the foundation for many meta-frameworks and a toolkit for building standalone servers.",[404,416,417,418,423,424,429],{},"With Nitro v3, we took the opportunity to rethink the fundamentals. leaner APIs, Web standards, first-class ",[408,419,422],{"href":420,"rel":421},"https://rolldown.rs/",[412],"Rolldown"," and ",[408,425,428],{"href":426,"rel":427},"https://vite.dev/",[412],"Vite v8"," integration, and a better experience for both humans and agents (more on that later!)",[404,431,432,433,438,439,444,445,450,451,456,457,462,463,468],{},"Since we quietly announced v3 ",[408,434,437],{"href":435,"rel":436},"https://github.com/nitrojs/nitro/releases/tag/v3.0.1-alpha.0",[412],"alpha.0"," (11 Oct 2025) at the first ",[408,440,443],{"href":441,"rel":442},"https://viteconf.amsterdam/",[412],"Vite Conf",", Nitro v3 has been adopted by many users (",[408,446,449],{"href":447,"rel":448},"https://npmtrends.com/nitro-vs-nitro-nightly",[412],"~280k"," weekly downloads!) and refined through amazing contributions and feedback. including ",[408,452,455],{"href":453,"rel":454},"https://tanstack.com/start/latest/docs/framework/react/guide/hosting#nitro",[412],"Tanstack Start",", ",[408,458,461],{"href":459,"rel":460},"https://useworkflow.dev/docs/getting-started",[412],"Vercel Workflows",", and production apps like ",[408,464,467],{"href":465,"rel":466},"https://t3.chat/",[412],"T3Chat",".",[404,470,471,472,476],{},"A huge thanks to the VoidZero (Vite and Rolldown), Nuxt (",[408,473,475],{"href":474},"#nuxt-v5","v5 is coming!",") and TanStack Start teams and every contributor who helped bring Nitro v3 to this milestone. ❤️",[399,478,480],{"id":479},"why-build-servers","Why Build Servers?",[404,482,483,484,488,489,492,493,496,497,500,501,505],{},"We don't ship raw source files to the browser. We use build tools because they solve real problems: ",[485,486,487],"strong",{},"HMR"," for instant feedback, ",[485,490,491],{},"code splitting"," to load only what a route needs, ",[485,494,495],{},"tree shaking"," to eliminate dead code, and ",[485,498,499],{},"minification"," for smaller payloads. Tools like Webpack and then ",[408,502,504],{"href":426,"rel":503},[412],"Vite"," transformed frontend development from painful to productive.",[404,507,508],{},"But frontend apps don't exist in isolation, they need APIs, databases, authentication, real-time data. They need a server.",[404,510,511,512,515,516,519,520,523],{},"With the rise of serverless and edge computing, the server side now faces the same constraints the frontend solved years ago. ",[485,513,514],{},"Cold starts"," mean every millisecond of startup matters. ",[485,517,518],{},"Memory limits"," are strict — bloated dependencies can push you over. ",[485,521,522],{},"Bundle size"," directly impacts deploy speed and boot time. And your code needs to run everywhere: Node.js, Deno, Bun, Cloudflare Workers, Vercel, etc. Yet most server frameworks still ship unoptimized, unbundled code, assuming a long-running process where none of this matters.",[404,525,526,527],{},"Nitro brings the build-tool philosophy to the backend. The same great DX you expect from frontend tooling: HMR for fast iteration and optimized builds powered by Rolldown with tree-shaken production output that performs as close to bare-metal as possible. ",[485,528,529],{},"One codebase, any runtime, any platform.",[399,531,533],{"id":532},"first-class-vite-integration","⚡ First-Class Vite Integration",[404,535,536,537,541],{},"Nitro now has a native ",[408,538,504],{"href":539,"rel":540},"https://vite.dev",[412]," plugin to build full stack apps.",[543,544,549],"pre",{"className":545,"code":546,"filename":547,"language":548,"meta":5,"style":5},"language-ts shiki shiki-themes github-light github-dark github-dark","import { defineConfig } from \"vite\";\nimport { nitro } from \"nitro/vite\";\n\nexport default defineConfig({\n  plugins: [nitro()],\n});\n","vite.config.ts","ts",[550,551,552,575,590,597,613,625],"code",{"__ignoreMap":5},[553,554,557,561,565,568,572],"span",{"class":555,"line":556},"line",1,[553,558,560],{"class":559},"so5gQ","import",[553,562,564],{"class":563},"slsVL"," { defineConfig } ",[553,566,567],{"class":559},"from",[553,569,571],{"class":570},"sfrk1"," \"vite\"",[553,573,574],{"class":563},";\n",[553,576,578,580,583,585,588],{"class":555,"line":577},2,[553,579,560],{"class":559},[553,581,582],{"class":563}," { nitro } ",[553,584,567],{"class":559},[553,586,587],{"class":570}," \"nitro/vite\"",[553,589,574],{"class":563},[553,591,593],{"class":555,"line":592},3,[553,594,596],{"emptyLinePlaceholder":595},true,"\n",[553,598,600,603,606,610],{"class":555,"line":599},4,[553,601,602],{"class":559},"export",[553,604,605],{"class":559}," default",[553,607,609],{"class":608},"shcOC"," defineConfig",[553,611,612],{"class":563},"({\n",[553,614,616,619,622],{"class":555,"line":615},5,[553,617,618],{"class":563},"  plugins: [",[553,620,621],{"class":608},"nitro",[553,623,624],{"class":563},"()],\n",[553,626,628],{"class":555,"line":627},6,[553,629,630],{"class":563},"});\n",[404,632,633,634,637],{},"Adding ",[550,635,636],{},"nitro()"," to your Vite apps gives you:",[639,640,641,648,654],"ul",{},[642,643,644,647],"li",{},[485,645,646],{},"API routes"," via filesystem routing",[642,649,650,653],{},[485,651,652],{},"Server-side rendering"," integrated with your frontend build",[642,655,656,659,660,663,664,667],{},[485,657,658],{},"A production server"," — a single ",[550,661,662],{},"vite build"," produces an optimized ",[550,665,666],{},".output/"," folder with both frontend and backend, ready to deploy",[404,669,670,671,674,675,456,678,423,681,468],{},"This means you can add a full backend to any Vite project — See ",[408,672,673],{"href":225},"examples"," with ",[408,676,677],{"href":348},"React",[408,679,680],{"href":366},"Vue",[408,682,683],{"href":352},"Solid.js",[399,685,687],{"id":686},"performance-by-default-zero-bloat","🚀 Performance by Default, Zero Bloat",[404,689,690],{},"Nitro compiles your routes at build time. There is no runtime router — each route loads on demand. Only the code needed to handle a specific request is loaded and executed.",[404,692,693,694,697,698,701,702,707,708,468],{},"Minimal server bundle built with the ",[550,695,696],{},"standard"," preset is less than ",[550,699,700],{},"10kB",", can be served with ",[408,703,706],{"href":704,"rel":705},"https://srvx.h3.dev/",[412],"srvx"," at close to native speeds, and includes all the good features from ",[408,709,712],{"href":710,"rel":711},"https://h3.dev/",[412],"H3",[404,714,715,716,721,722,468],{},"We have also significantly reduced the number of dependencies, down to ",[408,717,720],{"href":718,"rel":719},"https://npmgraph.js.org/?q=nitro-nightly",[412],"less than 20"," from ",[408,723,726],{"href":724,"rel":725},"https://npmgraph.js.org/?q=nitropack",[412],"321 dependencies",[399,728,730,731],{"id":729},"️-new-identity-nitro","🖌️ New Identity: ",[550,732,621],{},[404,734,735,736,742,743,468],{},"Nitro v3 ships under a new NPM package: ",[408,737,740],{"href":738,"rel":739},"https://npmx.dev/package/nitro",[412],[550,741,621],{},", replacing the legacy ",[550,744,745],{},"nitropack",[404,747,748,749,752],{},"All imports now use clean ",[550,750,751],{},"nitro/*"," subpaths:",[543,754,756],{"className":545,"code":755,"language":548,"meta":5,"style":5},"import { defineNitroConfig } from \"nitro/config\";\nimport { defineHandler } from \"nitro\";\nimport { useStorage } from \"nitro/storage\";\nimport { useDatabase } from \"nitro/database\";\n",[550,757,758,772,786,800],{"__ignoreMap":5},[553,759,760,762,765,767,770],{"class":555,"line":556},[553,761,560],{"class":559},[553,763,764],{"class":563}," { defineNitroConfig } ",[553,766,567],{"class":559},[553,768,769],{"class":570}," \"nitro/config\"",[553,771,574],{"class":563},[553,773,774,776,779,781,784],{"class":555,"line":577},[553,775,560],{"class":559},[553,777,778],{"class":563}," { defineHandler } ",[553,780,567],{"class":559},[553,782,783],{"class":570}," \"nitro\"",[553,785,574],{"class":563},[553,787,788,790,793,795,798],{"class":555,"line":592},[553,789,560],{"class":559},[553,791,792],{"class":563}," { useStorage } ",[553,794,567],{"class":559},[553,796,797],{"class":570}," \"nitro/storage\"",[553,799,574],{"class":563},[553,801,802,804,807,809,812],{"class":555,"line":599},[553,803,560],{"class":559},[553,805,806],{"class":563}," { useDatabase } ",[553,808,567],{"class":559},[553,810,811],{"class":570}," \"nitro/database\"",[553,813,574],{"class":563},[404,815,816,817,820],{},"No more deep ",[550,818,819],{},"nitropack/runtime/*"," paths, plus, you can import nitro subpaths outside of builder useful for unit testing.",[399,822,824],{"id":823},"bring-your-own-framework","🔧 Bring Your Own Framework",[404,826,827,828,831],{},"Nitro v3 is not opinionated about your HTTP layer. You can use the built-in filesystem routing, or take full control with a ",[550,829,830],{},"server.ts"," entry file and bring any framework you prefer:",[543,833,835],{"className":545,"code":834,"filename":830,"language":548,"meta":5,"style":5},"import { Hono } from \"hono\";\n\nconst app = new Hono();\napp.get(\"/\", (c) => c.text(\"Hello from Hono!\"));\n\nexport default app;\n",[550,836,837,851,855,876,917,921],{"__ignoreMap":5},[553,838,839,841,844,846,849],{"class":555,"line":556},[553,840,560],{"class":559},[553,842,843],{"class":563}," { Hono } ",[553,845,567],{"class":559},[553,847,848],{"class":570}," \"hono\"",[553,850,574],{"class":563},[553,852,853],{"class":555,"line":577},[553,854,596],{"emptyLinePlaceholder":595},[553,856,857,860,864,867,870,873],{"class":555,"line":592},[553,858,859],{"class":559},"const",[553,861,863],{"class":862},"suiK_"," app",[553,865,866],{"class":559}," =",[553,868,869],{"class":559}," new",[553,871,872],{"class":608}," Hono",[553,874,875],{"class":563},"();\n",[553,877,878,881,884,887,890,893,897,900,903,906,909,911,914],{"class":555,"line":599},[553,879,880],{"class":563},"app.",[553,882,883],{"class":608},"get",[553,885,886],{"class":563},"(",[553,888,889],{"class":570},"\"/\"",[553,891,892],{"class":563},", (",[553,894,896],{"class":895},"sQHwn","c",[553,898,899],{"class":563},") ",[553,901,902],{"class":559},"=>",[553,904,905],{"class":563}," c.",[553,907,908],{"class":608},"text",[553,910,886],{"class":563},[553,912,913],{"class":570},"\"Hello from Hono!\"",[553,915,916],{"class":563},"));\n",[553,918,919],{"class":555,"line":615},[553,920,596],{"emptyLinePlaceholder":595},[553,922,923,925,927],{"class":555,"line":627},[553,924,602],{"class":559},[553,926,605],{"class":559},[553,928,929],{"class":563}," app;\n",[399,931,933],{"id":932},"h3-v2-with-web-standards","🌐 H3 (v2) with Web Standards",[404,935,936,937,942,943,456,950,456,957,964,965,468],{},"Nitro v3 upgrades to ",[408,938,941],{"href":939,"rel":940},"https://h3.dev",[412],"H3 v2",", which has been fully rewritten around web standard primitives — ",[408,944,947],{"href":945,"rel":946},"https://developer.mozilla.org/en-US/docs/Web/API/Request",[412],[550,948,949],{},"Request",[408,951,954],{"href":952,"rel":953},"https://developer.mozilla.org/en-US/docs/Web/API/Response",[412],[550,955,956],{},"Response",[408,958,961],{"href":959,"rel":960},"https://developer.mozilla.org/en-US/docs/Web/API/Headers",[412],[550,962,963],{},"Headers",", and ",[408,966,969],{"href":967,"rel":968},"https://developer.mozilla.org/en-US/docs/Web/API/URL",[412],[550,970,971],{},"URL",[404,973,974],{},"The result is cleaner, more portable server code:",[543,976,979],{"className":545,"code":977,"filename":978,"language":548,"meta":5,"style":5},"import { defineHandler } from \"nitro\";\n\nexport default defineHandler((event) => {\n  const ua = event.req.headers.get(\"user-agent\");\n  return { message: \"Hello Nitro v3!\", ua };\n});\n","routes/hello.ts",[550,980,981,993,997,1019,1042,1056],{"__ignoreMap":5},[553,982,983,985,987,989,991],{"class":555,"line":556},[553,984,560],{"class":559},[553,986,778],{"class":563},[553,988,567],{"class":559},[553,990,783],{"class":570},[553,992,574],{"class":563},[553,994,995],{"class":555,"line":577},[553,996,596],{"emptyLinePlaceholder":595},[553,998,999,1001,1003,1006,1009,1012,1014,1016],{"class":555,"line":592},[553,1000,602],{"class":559},[553,1002,605],{"class":559},[553,1004,1005],{"class":608}," defineHandler",[553,1007,1008],{"class":563},"((",[553,1010,1011],{"class":895},"event",[553,1013,899],{"class":563},[553,1015,902],{"class":559},[553,1017,1018],{"class":563}," {\n",[553,1020,1021,1024,1027,1029,1032,1034,1036,1039],{"class":555,"line":599},[553,1022,1023],{"class":559},"  const",[553,1025,1026],{"class":862}," ua",[553,1028,866],{"class":559},[553,1030,1031],{"class":563}," event.req.headers.",[553,1033,883],{"class":608},[553,1035,886],{"class":563},[553,1037,1038],{"class":570},"\"user-agent\"",[553,1040,1041],{"class":563},");\n",[553,1043,1044,1047,1050,1053],{"class":555,"line":615},[553,1045,1046],{"class":559},"  return",[553,1048,1049],{"class":563}," { message: ",[553,1051,1052],{"class":570},"\"Hello Nitro v3!\"",[553,1054,1055],{"class":563},", ua };\n",[553,1057,1058],{"class":555,"line":627},[553,1059,630],{"class":563},[404,1061,1062],{},"Reading request bodies uses native APIs:",[543,1064,1067],{"className":545,"code":1065,"filename":1066,"language":548,"meta":5,"style":5},"import { defineHandler } from \"nitro\";\n\nexport default defineHandler(async (event) => {\n  const body = await event.req.json();\n  return { received: body };\n});\n","routes/submit.ts",[550,1068,1069,1081,1085,1109,1129,1136],{"__ignoreMap":5},[553,1070,1071,1073,1075,1077,1079],{"class":555,"line":556},[553,1072,560],{"class":559},[553,1074,778],{"class":563},[553,1076,567],{"class":559},[553,1078,783],{"class":570},[553,1080,574],{"class":563},[553,1082,1083],{"class":555,"line":577},[553,1084,596],{"emptyLinePlaceholder":595},[553,1086,1087,1089,1091,1093,1095,1098,1101,1103,1105,1107],{"class":555,"line":592},[553,1088,602],{"class":559},[553,1090,605],{"class":559},[553,1092,1005],{"class":608},[553,1094,886],{"class":563},[553,1096,1097],{"class":559},"async",[553,1099,1100],{"class":563}," (",[553,1102,1011],{"class":895},[553,1104,899],{"class":563},[553,1106,902],{"class":559},[553,1108,1018],{"class":563},[553,1110,1111,1113,1116,1118,1121,1124,1127],{"class":555,"line":599},[553,1112,1023],{"class":559},[553,1114,1115],{"class":862}," body",[553,1117,866],{"class":559},[553,1119,1120],{"class":559}," await",[553,1122,1123],{"class":563}," event.req.",[553,1125,1126],{"class":608},"json",[553,1128,875],{"class":563},[553,1130,1131,1133],{"class":555,"line":615},[553,1132,1046],{"class":559},[553,1134,1135],{"class":563}," { received: body };\n",[553,1137,1138],{"class":555,"line":627},[553,1139,630],{"class":563},[404,1141,1142],{},"No wrappers, no abstractions for things the platform already provides. If you know the Web API, you know H3 v2.",[404,1144,1145,456,1149,456,1153,1157],{},[408,1146,255],{"href":1147,"rel":1148},"https://elysiajs.com/",[412],[408,1150,1152],{"href":939,"rel":1151},[412],"h3",[408,1154,275],{"href":1155,"rel":1156},"https://hono.dev",[412]," — anything that speaks web standards works with Nitro.",[399,1159,1161],{"id":1160},"️-built-in-primitives","🗄️ Built-in Primitives",[404,1163,1164,1165,1168],{},"Nitro ships with powerful but small and ",[485,1166,1167],{},"fully opt-in"," agnostic server primitives that work across every runtime.",[1170,1171,1172],"note",{},[404,1173,1174,1175,423,1180,1185],{},"When not used, nothing extra will be added to the server bundle. You can still use native platform primitives alongside Nitro's built-in ones.\nWe are also bringing first class emulation for platform-specific primitives for dev See ",[408,1176,1179],{"href":1177,"rel":1178},"https://github.com/unjs/env-runner",[412],"env-runner",[408,1181,1184],{"href":1182,"rel":1183},"https://github.com/nitrojs/nitro/pull/4088",[412],"nitrojs/nitro#4088"," for more details.",[1152,1187,1189],{"id":1188},"storage","Storage",[404,1191,1192,1193,1198],{},"A runtime-agnostic key-value layer with 20+ drivers — FS, Redis, S3, Cloudflare KV, Vercel Blob and ",[408,1194,1197],{"href":1195,"rel":1196},"https://unstorage.unjs.io/drivers",[412],"more",". Attach drivers to namespaces and swap them without changing your application code.",[543,1200,1202],{"className":545,"code":1201,"language":548,"meta":5,"style":5},"import { useStorage } from \"nitro/storage\";\n\nconst storage = useStorage();\nawait storage.setItem(\"user:1\", { name: \"Nitro\" });\n",[550,1203,1204,1216,1220,1234],{"__ignoreMap":5},[553,1205,1206,1208,1210,1212,1214],{"class":555,"line":556},[553,1207,560],{"class":559},[553,1209,792],{"class":563},[553,1211,567],{"class":559},[553,1213,797],{"class":570},[553,1215,574],{"class":563},[553,1217,1218],{"class":555,"line":577},[553,1219,596],{"emptyLinePlaceholder":595},[553,1221,1222,1224,1227,1229,1232],{"class":555,"line":592},[553,1223,859],{"class":559},[553,1225,1226],{"class":862}," storage",[553,1228,866],{"class":559},[553,1230,1231],{"class":608}," useStorage",[553,1233,875],{"class":563},[553,1235,1236,1239,1242,1245,1247,1250,1253,1256],{"class":555,"line":599},[553,1237,1238],{"class":559},"await",[553,1240,1241],{"class":563}," storage.",[553,1243,1244],{"class":608},"setItem",[553,1246,886],{"class":563},[553,1248,1249],{"class":570},"\"user:1\"",[553,1251,1252],{"class":563},", { name: ",[553,1254,1255],{"class":570},"\"Nitro\"",[553,1257,1258],{"class":563}," });\n",[1260,1261],"read-more",{"to":74},[1152,1263,1265],{"id":1264},"caching","Caching",[404,1267,1268],{},"Cache server routes and functions, backed by the storage layer. Supports stale-while-revalidate, TTL, and custom cache keys out of the box.",[543,1270,1272],{"className":545,"code":1271,"language":548,"meta":5,"style":5},"import { defineCachedHandler } from \"nitro/cache\";\n\nexport default defineCachedHandler((event) => {\n  return \"I am cached for an hour\";\n}, { maxAge: 60 * 60 });\n",[550,1273,1274,1288,1292,1311,1320],{"__ignoreMap":5},[553,1275,1276,1278,1281,1283,1286],{"class":555,"line":556},[553,1277,560],{"class":559},[553,1279,1280],{"class":563}," { defineCachedHandler } ",[553,1282,567],{"class":559},[553,1284,1285],{"class":570}," \"nitro/cache\"",[553,1287,574],{"class":563},[553,1289,1290],{"class":555,"line":577},[553,1291,596],{"emptyLinePlaceholder":595},[553,1293,1294,1296,1298,1301,1303,1305,1307,1309],{"class":555,"line":592},[553,1295,602],{"class":559},[553,1297,605],{"class":559},[553,1299,1300],{"class":608}," defineCachedHandler",[553,1302,1008],{"class":563},[553,1304,1011],{"class":895},[553,1306,899],{"class":563},[553,1308,902],{"class":559},[553,1310,1018],{"class":563},[553,1312,1313,1315,1318],{"class":555,"line":599},[553,1314,1046],{"class":559},[553,1316,1317],{"class":570}," \"I am cached for an hour\"",[553,1319,574],{"class":563},[553,1321,1322,1325,1328,1331,1334],{"class":555,"line":615},[553,1323,1324],{"class":563},"}, { maxAge: ",[553,1326,1327],{"class":862},"60",[553,1329,1330],{"class":559}," *",[553,1332,1333],{"class":862}," 60",[553,1335,1258],{"class":563},[1260,1337],{"to":69},[1152,1339,38],{"id":1340},"database",[404,1342,1343,1344,1348],{},"A built-in SQL database that defaults to SQLite for development and can connect to Postgres, MySQL, and ",[408,1345,1197],{"href":1346,"rel":1347},"https://db0.unjs.io/connectors",[412]," using the same API.",[543,1350,1352],{"className":545,"code":1351,"language":548,"meta":5,"style":5},"import { useDatabase } from \"nitro/database\";\n\nconst db = useDatabase();\nconst users = await db.sql`SELECT * FROM users`;\n",[550,1353,1354,1366,1370,1384],{"__ignoreMap":5},[553,1355,1356,1358,1360,1362,1364],{"class":555,"line":556},[553,1357,560],{"class":559},[553,1359,806],{"class":563},[553,1361,567],{"class":559},[553,1363,811],{"class":570},[553,1365,574],{"class":563},[553,1367,1368],{"class":555,"line":577},[553,1369,596],{"emptyLinePlaceholder":595},[553,1371,1372,1374,1377,1379,1382],{"class":555,"line":592},[553,1373,859],{"class":559},[553,1375,1376],{"class":862}," db",[553,1378,866],{"class":559},[553,1380,1381],{"class":608}," useDatabase",[553,1383,875],{"class":563},[553,1385,1386,1388,1391,1393,1395,1398,1401,1404],{"class":555,"line":599},[553,1387,859],{"class":559},[553,1389,1390],{"class":862}," users",[553,1392,866],{"class":559},[553,1394,1120],{"class":559},[553,1396,1397],{"class":563}," db.",[553,1399,1400],{"class":608},"sql",[553,1402,1403],{"class":570},"`SELECT * FROM users`",[553,1405,574],{"class":563},[1260,1407],{"to":39},[399,1409,1411],{"id":1410},"deploy-anywhere","🌍 Deploy Anywhere",[404,1413,1414,1415,1417],{},"Build your server into an optimized ",[550,1416,666],{}," folder compatible with:",[639,1419,1420,1425],{},[642,1421,1422,1424],{},[485,1423,96],{},": Node.js, Bun, Deno",[642,1426,1427,1430],{},[485,1428,1429],{},"Platforms",": Cloudflare Workers, Netlify, Vercel, AWS Lambda, Azure, Firebase, Deno Deploy, and more",[404,1432,1433],{},"No configuration needed — Nitro auto-detects your deployment target. Take advantage of platform features like ISR, SWR, and edge rendering without changing a single line of code.",[399,1435,1437],{"id":1436},"server-side-rendering","🎨 Server-Side Rendering",[404,1439,1440],{},"Render HTML with your favorite templating engine, or use component libraries like React, Vue, or Svelte directly on the server. Go full universal rendering with client-side hydration.",[404,1442,1443],{},"Nitro provides the foundation and a progressive approach — start with API routes, add rendering when you need it, and scale to full SSR at your own pace.",[1260,1445],{"to":19},[399,1447,1449],{"id":1448},"nuxt-v5","🟢 Nuxt v5",[404,1451,1452,1453,468],{},"Nitro v3 will power the next major version of ",[408,1454,1456],{"href":410,"rel":1455},[412],"Nuxt",[404,1458,1459,1464],{},[408,1460,1463],{"href":1461,"rel":1462},"https://nuxt.com/blog/roadmap-v4",[412],"Nuxt v5"," will ship with Nitro v3 and H3 v2 at its core, bringing web-standard request handling, Rolldown-powered builds, and the Vite Environment API to the Nuxt ecosystem.",[404,1466,1467,1468,1473],{},"If you're a Nuxt user, you can already start preparing by familiarizing yourself with  Nitro v3's new APIs, which will carry directly into Nuxt 5, and you can ",[408,1469,1472],{"href":1470,"rel":1471},"https://github.com/nuxt/nuxt/discussions/34504",[412],"follow progress"," on adopting Nitro v3 in Nuxt",[399,1475,1477],{"id":1476},"getting-started","🏁 Getting Started",[1152,1479,1481],{"id":1480},"create-a-new-project","Create a New Project",[1483,1484],"pm-x",{"command":1485},"create-nitro-app",[404,1487,1488,1489,1492],{},"See the ",[408,1490,1491],{"href":14},"quick start guide"," for a full step-by-step walkthrough.",[399,1494,1496],{"id":1495},"migrating-from-v2","🔄 Migrating from v2",[404,1498,1499],{},"Nitro v3 introduces intentional breaking changes to set a cleaner foundation. Here are the key ones:",[639,1501,1502,1510,1517,1526,1534,1541,1547],{},[642,1503,1504,1506,1507,1509],{},[550,1505,745],{}," → ",[550,1508,621],{}," (package rename)",[642,1511,1512,1506,1514,1516],{},[550,1513,819],{},[550,1515,751],{}," (clean subpath imports)",[642,1518,1519,1506,1522,1525],{},[550,1520,1521],{},"eventHandler",[550,1523,1524],{},"defineHandler"," (H3 v2)",[642,1527,1528,1506,1531,1525],{},[550,1529,1530],{},"createError",[550,1532,1533],{},"HTTPError",[642,1535,1536,1537,1540],{},"Web standard ",[550,1538,1539],{},"event.req"," headers and body APIs",[642,1542,1543,1544],{},"Node.js minimum version: ",[485,1545,1546],{},"20",[642,1548,1549,1550,1506,1553,1556],{},"Preset renames and consolidation (e.g., ",[550,1551,1552],{},"cloudflare",[550,1554,1555],{},"cloudflare_module",")",[404,1558,1559,1560,468],{},"For a complete list, see the ",[408,1561,1562],{"href":79},"migration guide",[1564,1565],"hr",{},[404,1567,1568],{},"Thank you to everyone who has contributed to Nitro over the years. We can't wait to see what you build with the new Nitro! ❤️",[639,1570,1571,1579],{},[642,1572,1573,1578],{},[408,1574,1577],{"href":1575,"rel":1576},"https://github.com/nitrojs/nitro",[412],"GitHub"," — Issues and discussions",[642,1580,1581,1586],{},[408,1582,1585],{"href":1583,"rel":1584},"https://discord.nitro.build",[412],"Discord"," — Chat with the community",[1588,1589,1590],"style",{},"html pre.shiki code .so5gQ, html code.shiki .so5gQ{--shiki-light:#D73A49;--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .slsVL, html code.shiki .slsVL{--shiki-light:#24292E;--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .sfrk1, html code.shiki .sfrk1{--shiki-light:#032F62;--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html pre.shiki code .shcOC, html code.shiki .shcOC{--shiki-light:#6F42C1;--shiki-default:#B392F0;--shiki-dark:#B392F0}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .suiK_, html code.shiki .suiK_{--shiki-light:#005CC5;--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .sQHwn, html code.shiki .sQHwn{--shiki-light:#E36209;--shiki-default:#FFAB70;--shiki-dark:#FFAB70}",{"title":5,"searchDepth":577,"depth":577,"links":1592},[1593,1594,1595,1596,1597,1599,1600,1601,1606,1607,1608,1609,1612],{"id":401,"depth":577,"text":402},{"id":479,"depth":577,"text":480},{"id":532,"depth":577,"text":533},{"id":686,"depth":577,"text":687},{"id":729,"depth":577,"text":1598},"🖌️ New Identity: nitro",{"id":823,"depth":577,"text":824},{"id":932,"depth":577,"text":933},{"id":1160,"depth":577,"text":1161,"children":1602},[1603,1604,1605],{"id":1188,"depth":592,"text":1189},{"id":1264,"depth":592,"text":1265},{"id":1340,"depth":592,"text":38},{"id":1410,"depth":577,"text":1411},{"id":1436,"depth":577,"text":1437},{"id":1448,"depth":577,"text":1449},{"id":1476,"depth":577,"text":1477,"children":1610},[1611],{"id":1480,"depth":592,"text":1481},{"id":1495,"depth":577,"text":1496},"Nitro v3 is now available as a public beta — a ground-up evolution of the server framework, built around web standards, Rolldown, Vite v8, and the same deploy-anywhere promise.","md",{"date":1616,"category":1617,"authors":1618,"icon":385},"2026-03-11","release",[1619],{"name":1620,"github":1621},"Pooya Parsa","pi0",{"icon":385},{"title":387,"description":1613},"Hb62Zadr-PaU06SzG7J4BDpm3lmOnHwUwKY8MosspyU",1775753655175]