feat: opt-in filesystem routing using serverDir config

[pi0]

This PR makes Nitro filesystem routing (and other scan features like server/middleware, etc) opt-in by default behind a new serverDir: string | false config replacing srcDir and defaulting to false.

Opting-in to filesystem features:

nitro.config.ts:

import { defineNitroConfig } from "nitro/config";

export default defineNitroConfig({
  serverDir: "./server"
});

vite.config.ts:

import { defineConfig } from "vite";
import { nitro } from "nitro/vite";

export default defineConfig({
  plugins: [nitro()],
  nitro: { serverDir: true },
});

Note

Routing system is always available without filesystem. Together with #3718, defining routes via config is more convinient now using simple routes: {} object.

All internal resolutions for relative paths now consistantly happen from rootDir.

Some special files will be scanned from rootDir (priority):

• index.html template
• entry-server (vite SSR entry)
• public/ dir
• server.[ext]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
nitro.build	Ready	Preview	Comment	Nov 3, 2025 2:21pm

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/nitrojs/nitro@3719

commit: fb6fd7c