vitejs · github-actions · Apr 27, 2026 · May 7, 2026 · May 11, 2026
diff --git a/_data/team.js b/_data/team.js
@@ -0,0 +1 @@
+      { icon: 'x', link: 'https://x.com/evanyou' },
diff --git a/config/build-options.md b/config/build-options.md
@@ -0,0 +1,2 @@
+By default, a [module preload polyfill](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) is automatically injected. The polyfill is auto injected into the proxy module of each `index.html` entry. If the build is configured to use a non-HTML custom entry via `build.rolldownOptions.input`, then it is necessary to manually import the polyfill in your custom entry:
+Produce SSR-oriented build. The value can be a string to directly specify the SSR entry, or `true`, which requires specifying the SSR entry via `rolldownOptions.input`.
diff --git a/config/dep-optimization-options.md b/config/dep-optimization-options.md
@@ -0,0 +1 @@
+By default, Vite will crawl all your `.html` files to detect dependencies that need to be pre-bundled (ignoring `node_modules`, `build.outDir`, `__tests__` and `coverage`). If `build.rolldownOptions.input` is specified, Vite will crawl those entry points instead.
diff --git a/config/server-options.md b/config/server-options.md
@@ -0,0 +1,2 @@
+`server.sourcemapIgnoreList` is the equivalent of [`build.rolldownOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) for the dev server. A difference between the two config options is that the rollup function is called with a relative path for `sourcePath` while `server.sourcemapIgnoreList` is called with an absolute path. During dev, most modules have the map and the source in the same folder, so the relative path for `sourcePath` is the file name itself. In these cases, absolute paths makes it convenient to be used instead.
+[`server.sourcemapIgnoreList`](#server-sourcemapignorelist) and [`build.rolldownOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) need to be set independently. `server.sourcemapIgnoreList` is a server only config and doesn't get its default value from the defined rollup options.
diff --git a/config/shared-options.md b/config/shared-options.md
@@ -0,0 +1 @@
+For SSR builds, deduplication does not work for ESM build outputs configured from `build.rolldownOptions.output`. A workaround is to use CJS build outputs until ESM has better plugin support for module loading.
diff --git a/guide/api-javascript.md b/guide/api-javascript.md
@@ -0,0 +1,3 @@
+Note that `null` and `undefined` values in `overrides` are skipped and not merged. If you need to explicitly clear a value from `defaults`, modify the result of `mergeConfig` directly.
+
+    rolldownOptions: {
diff --git a/guide/backend-integration.md b/guide/backend-integration.md
@@ -0,0 +1,2 @@
+       rolldownOptions: {
+   - **Entry chunks**: Generated from files specified in [`build.rolldownOptions.input`](https://rollupjs.org/configuration-options/#input). These chunks have `isEntry: true` and their key is the relative src path from project root.
diff --git a/guide/cli.md b/guide/cli.md
@@ -0,0 +1,52 @@
+| Options                        |                                                                                                                                                                                       |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--target <target>`            | Transpile target (default: `"baseline-widely-available"`) (`string`)                                                                                                                  |
+| `--outDir <dir>`               | Output directory (default: `dist`) (`string`)                                                                                                                                         |
+| `--assetsDir <dir>`            | Directory under outDir to place assets in (default: `"assets"`) (`string`)                                                                                                            |
+| `--assetsInlineLimit <number>` | Static asset base64 inline threshold in bytes (default: `4096`) (`number`)                                                                                                            |
+| `--ssr [entry]`                | Build specified entry for server-side rendering (`string`)                                                                                                                            |
+| `--sourcemap [output]`         | Output source maps for build (default: `false`) (`boolean \| "inline" \| "hidden"`)                                                                                                   |
+| `--minify [minifier]`          | Enable/disable minification, or specify minifier to use (default: `"oxc"`) (`boolean \| "oxc" \| "terser" \| "esbuild"`)                                                              |
+| `--manifest [name]`            | Emit build manifest json (`boolean \| string`)                                                                                                                                        |
+| `--ssrManifest [name]`         | Emit ssr manifest json (`boolean \| string`)                                                                                                                                          |
+| `--emptyOutDir`                | Force empty outDir when it's outside of root (`boolean`)                                                                                                                              |
+| `-w, --watch`                  | Rebuilds when modules have changed on disk (`boolean`)                                                                                                                                |
+| `-c, --config <file>`          | Use specified config file (`string`)                                                                                                                                                  |
+| `--base <path>`                | Public base path (default: `/`) (`string`)                                                                                                                                            |
+| `-l, --logLevel <level>`       | Info \| warn \| error \| silent (`string`)                                                                                                                                            |
+| `--clearScreen`                | Allow/disable clear screen when logging (`boolean`)                                                                                                                                   |
+| `--configLoader <loader>`      | Use `bundle` to bundle the config with Rolldown, or `runner` (experimental) to process it on the fly, or `native` (experimental) to load using the native runtime (default: `bundle`) |
+| `--profile`                    | Start built-in Node.js inspector (check [Performance bottlenecks](/guide/troubleshooting#performance-bottlenecks))                                                                    |
+| `-d, --debug [feat]`           | Show debug logs (`string \| boolean`)                                                                                                                                                 |
+| `-f, --filter <filter>`        | Filter debug logs (`string`)                                                                                                                                                          |
+| `-m, --mode <mode>`            | Set env mode (`string`)                                                                                                                                                               |
+| `-h, --help`                   | Display available CLI options                                                                                                                                                         |
+| `--app`                        | Build all environments, same as `builder: {}` (`boolean`, experimental)                                                                                                               |
+| Options                   |                                                                                                                                                                                       |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--force`                 | Force the optimizer to ignore the cache and re-bundle (`boolean`)                                                                                                                     |
+| `-c, --config <file>`     | Use specified config file (`string`)                                                                                                                                                  |
+| `--base <path>`           | Public base path (default: `/`) (`string`)                                                                                                                                            |
+| `-l, --logLevel <level>`  | Info \| warn \| error \| silent (`string`)                                                                                                                                            |
+| `--clearScreen`           | Allow/disable clear screen when logging (`boolean`)                                                                                                                                   |
+| `--configLoader <loader>` | Use `bundle` to bundle the config with Rolldown, or `runner` (experimental) to process it on the fly, or `native` (experimental) to load using the native runtime (default: `bundle`) |
+| `-d, --debug [feat]`      | Show debug logs (`string \| boolean`)                                                                                                                                                 |
+| `-f, --filter <filter>`   | Filter debug logs (`string`)                                                                                                                                                          |
+| `-m, --mode <mode>`       | Set env mode (`string`)                                                                                                                                                               |
+| `-h, --help`              | Display available CLI options                                                                                                                                                         |
+| Options                   |                                                                                                                                                                                       |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--host [host]`           | Specify hostname (`string`)                                                                                                                                                           |
+| `--port <port>`           | Specify port (`number`)                                                                                                                                                               |
+| `--strictPort`            | Exit if specified port is already in use (`boolean`)                                                                                                                                  |
+| `--open [path]`           | Open browser on startup (`boolean \| string`)                                                                                                                                         |
+| `--outDir <dir>`          | Output directory (default: `dist`)(`string`)                                                                                                                                          |
+| `-c, --config <file>`     | Use specified config file (`string`)                                                                                                                                                  |
+| `--base <path>`           | Public base path (default: `/`) (`string`)                                                                                                                                            |
+| `-l, --logLevel <level>`  | Info \| warn \| error \| silent (`string`)                                                                                                                                            |
+| `--clearScreen`           | Allow/disable clear screen when logging (`boolean`)                                                                                                                                   |
+| `--configLoader <loader>` | Use `bundle` to bundle the config with Rolldown, or `runner` (experimental) to process it on the fly, or `native` (experimental) to load using the native runtime (default: `bundle`) |
+| `-d, --debug [feat]`      | Show debug logs (`string \| boolean`)                                                                                                                                                 |
+| `-f, --filter <filter>`   | Filter debug logs (`string`)                                                                                                                                                          |
+| `-m, --mode <mode>`       | Set env mode (`string`)                                                                                                                                                               |
+| `-h, --help`              | Display available CLI options                                                                                                                                                         |
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		By default, a [module preload polyfill](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) is automatically injected. The polyfill is auto injected into the proxy module of each `index.html` entry. If the build is configured to use a non-HTML custom entry via `build.rolldownOptions.input`, then it is necessary to manually import the polyfill in your custom entry:
		Produce SSR-oriented build. The value can be a string to directly specify the SSR entry, or `true`, which requires specifying the SSR entry via `rolldownOptions.input`.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		By default, Vite will crawl all your `.html` files to detect dependencies that need to be pre-bundled (ignoring `node_modules`, `build.outDir`, `__tests__` and `coverage`). If `build.rolldownOptions.input` is specified, Vite will crawl those entry points instead.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		`server.sourcemapIgnoreList` is the equivalent of [`build.rolldownOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) for the dev server. A difference between the two config options is that the rollup function is called with a relative path for `sourcePath` while `server.sourcemapIgnoreList` is called with an absolute path. During dev, most modules have the map and the source in the same folder, so the relative path for `sourcePath` is the file name itself. In these cases, absolute paths makes it convenient to be used instead.
		[`server.sourcemapIgnoreList`](#server-sourcemapignorelist) and [`build.rolldownOptions.output.sourcemapIgnoreList`](https://rollupjs.org/configuration-options/#output-sourcemapignorelist) need to be set independently. `server.sourcemapIgnoreList` is a server only config and doesn't get its default value from the defined rollup options.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		For SSR builds, deduplication does not work for ESM build outputs configured from `build.rolldownOptions.output`. A workaround is to use CJS build outputs until ESM has better plugin support for module loading.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		Note that `null` and `undefined` values in `overrides` are skipped and not merged. If you need to explicitly clear a value from `defaults`, modify the result of `mergeConfig` directly.

		rolldownOptions: {
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		rolldownOptions: {
		- Entry chunks: Generated from files specified in [`build.rolldownOptions.input`](https://rollupjs.org/configuration-options/#input). These chunks have `isEntry: true` and their key is the relative src path from project root.