docs: document vite client and server options (#35090)

mohitkum4r · danielroe · commit c3e5f11b4802 · 2026-06-02T14:07:00.000+01:00
diff --git a/docs/4.api/6.nuxt-config.md b/docs/4.api/6.nuxt-config.md
@@ -1604,9 +1604,47 @@ export default defineNuxtConfig({
 
 Configuration that will be passed directly to Vite.
 
+Top-level `vite` options are shared across both client and server environments. Use `$client` and `$server` to provide environment-specific configuration that will be merged into their respective builds.
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+  vite: {
+    $client: {
+      build: {
+        rollupOptions: {
+          output: {
+            manualChunks: {
+              analytics: ['analytics-package'],
+            },
+          },
+        },
+      },
+    },
+    $server: {
+      build: {
+        sourcemap: 'inline',
+      },
+    },
+  },
+})
+```
+
 **See**: [Vite configuration docs](https://vite.dev/config/) for more information.
 Please note that not all vite options are supported in Nuxt.
 
+### `$client`
+
+Configuration that will be merged into Vite's configuration for the client (browser) build.
+
+- **Type**: `object`
+
+### `$server`
+
+Configuration that will be merged into Vite's configuration for the server build.
+
+- **Type**: `object`
+
 ### `build`
 
 #### `assetsDir`
