docs: mpa

docs/.vitepress/config.ts

@@ -109,6 +109,16 @@ function sidebarGuide() {
         { text: 'Connecting to a CMS', link: '/guide/cms' }
       ]
     },
+    {
+      text: 'Experimental',
+      collapsed: false,
+      items: [
+        {
+          text: 'MPA Mode',
+          link: '/guide/mpa-mode'
+        }
+      ]
+    },
     // {
     //   text: 'Migrations',
     //   collapsed: false,

docs/guide/mpa-mode.md

@@ -0,0 +1 @@
+# MPA Mode

docs/reference/cli.md

@@ -39,7 +39,7 @@ vitepress build [root]
 
 | Option | Description |
 | -      | -           |
-| `--mpa` (experimental) | Build in MPA mode without client-side hydration (`boolean`) |
+| `--mpa` (experimental) | Build in [MPA mode](/guide/mpa-mode) without client-side hydration (`boolean`) |
 | `--base <path>`          | Public base path (default: `/`) (`string`) |
 | `--target <target>`            | Transpile target (default: `"modules"`) (`string`) |
 | `--outDir <dir>`          | Output directory (default: `.vitepress/dist`) (`string`) |

docs/reference/site-config.md

@@ -293,6 +293,13 @@ export default {
 }
 ```
 
+### mpa <Badge type="warning" text="experimental" />
+
+- Type: `boolean`
+- Default: `false`
+
+When set to `true`, the production app will be built in [MAP Mode](/guide/mpa-mode). MPA mode ships 0kb JavaScript by default, at the cost of disabling client-side navigation and requires explicit opt-in for interactivity.
+
 ## Theming
 
 ### appearance