@nuxt/docs-nightly 4.2.0-29338985.3c38d1f8 → 4.2.0-29344151.f836eca0

package/3.api/6.nuxt-config.md

@@ -424,9 +424,60 @@ A unique identifier matching the build. This may contain the hash of the current
 
 The builder to use for bundling the Vue part of your application.
 
-- **Type**: `string`
+Nuxt supports multiple builders for the client-side application. By default, Vite is used, but you can switch to webpack, Rspack, or even provide a custom builder implementation.
+
+- **Type**: `'vite' | 'webpack' | 'rspack' | string | { bundle: (nuxt: Nuxt) => Promise<void> }`
 - **Default:** `"@nuxt/vite-builder"`
 
+**Using supported builders:**
+
+```ts
+export default defineNuxtConfig({
+  // default - uses @nuxt/vite-builder
+  // builder: 'vite',
+
+  // uses @nuxt/webpack-builder
+  // builder: 'webpack',
+
+  // uses @nuxt/rspack-builder
+  builder: 'rspack',
+})
+```
+
+If you are using `webpack` or `rspack` you will need to make sure `@nuxt/webpack-builder` or `@nuxt/rspack-builder` is explicitly installed in your project.
+
+**Using a custom builder object:**
+
+You can provide a custom builder by passing an object with a `bundle` function:
+
+```ts
+export default defineNuxtConfig({
+  builder: {
+    async bundle (nuxt) {
+      const entry = await resolvePath(resolve(nuxt.options.appDir, 'entry'))
+
+      // Build client and server bundles
+      await buildClient(nuxt, entry)
+      if (nuxt.options.ssr) {
+        await buildServer(nuxt, entry)
+      }
+
+      // ... it's a bit more complicated than that, of course!
+    },
+  },
+})
+```
+
+**Creating a custom builder package:**
+
+To create a custom builder as a separate package, it should export a `bundle` function. You can then specify the package name in your `nuxt.config.ts`:
+
+```ts
+export default defineNuxtConfig({
+  builder: 'my-custom-builder',
+})
+```
+
 ## compatibilityDate
 
 Specify a compatibility date for your app.
@@ -1218,6 +1269,23 @@ export default defineNuxtConfig({
 })
 ```
 
+## server
+
+Configuration for Nuxt's server builder.
+
+### `builder`
+
+Specify the server builder to use for bundling the server part of your application.
+
+By default, Nuxt uses `@nuxt/nitro-server`, which provides standalone Nitro integration. This architecture allows for different Nitro integration patterns, such as using Nitro as a Vite plugin (with the Vite Environment API).
+
+- **Type**: `string | { bundle: (nuxt: Nuxt) => Promise<void> }`
+- **Default:** `"@nuxt/nitro-server"`
+
+::callout{type="warning"}
+This option is intended for internal use and the API is not finalized. Please open an issue before relying on the current implementation.
+::
+
 ## serverDir
 
 Define the server directory of your Nuxt application, where Nitro routes, middleware and plugins are kept.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/docs-nightly",
-  "version": "4.2.0-29338985.3c38d1f8",
+  "version": "4.2.0-29344151.f836eca0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",