docs: restructure docs

Author: antfu

docs/.vitepress/config.ts

@@ -16,10 +16,9 @@ function listErrorCodes(prefix: string): string[] {
     .sort()
 }
 
-function guideItems(prefix: string): DefaultTheme.NavItemWithLink[] {
+function guideItems(prefix: string) {
   return [
     { text: 'Introduction', link: `${prefix}/guide/` },
-    { text: 'Built with Devframe', link: `${prefix}/guide/built-with` },
     { text: 'Devframe Definition', link: `${prefix}/guide/devframe-definition` },
     { text: 'Scoped Context', link: `${prefix}/guide/scoped-context` },
     { text: 'RPC', link: `${prefix}/guide/rpc` },
@@ -30,14 +29,13 @@ function guideItems(prefix: string): DefaultTheme.NavItemWithLink[] {
     { text: 'Client', link: `${prefix}/guide/client` },
     { text: 'Security', link: `${prefix}/guide/security` },
     { text: 'Standalone CLI', link: `${prefix}/guide/standalone-cli` },
-    { text: 'Hub (multi-tool)', link: `${prefix}/guide/hub` },
+    { text: 'Hub', link: `${prefix}/guide/hub` },
     { text: 'Client Scripts & Context', link: `${prefix}/guide/client-context` },
     { text: 'Agent-Native (experimental)', link: `${prefix}/guide/agent-native` },
-    { text: 'Migrating to 0.6', link: `${prefix}/guide/migration-0.6` },
-  ]
+  ] satisfies DefaultTheme.NavItemWithLink[]
 }
 
-function adaptersItems(prefix: string): DefaultTheme.NavItemWithLink[] {
+function adaptersItems(prefix: string) {
   return [
     { text: 'Overview', link: `${prefix}/adapters/` },
     { text: 'CLI', link: `${prefix}/adapters/cli` },
@@ -46,40 +44,41 @@ function adaptersItems(prefix: string): DefaultTheme.NavItemWithLink[] {
     { text: 'Vite', link: `${prefix}/adapters/vite` },
     { text: 'Embedded', link: `${prefix}/adapters/embedded` },
     { text: 'MCP', link: `${prefix}/adapters/mcp` },
-  ]
+  ] satisfies DefaultTheme.NavItemWithLink[]
 }
 
-function helpersItems(prefix: string): DefaultTheme.NavItemWithLink[] {
+function helpersItems(prefix: string) {
   return [
     { text: 'Overview', link: `${prefix}/helpers/` },
     { text: 'Utilities', link: `${prefix}/helpers/utilities` },
     { text: 'Vite Bridge', link: `${prefix}/helpers/vite-bridge` },
     { text: 'Nuxt Module', link: `${prefix}/helpers/nuxt` },
     { text: 'Open Helpers', link: `${prefix}/helpers/open-helpers` },
     { text: 'Interactive Auth', link: `${prefix}/helpers/interactive-auth` },
-  ]
+  ] satisfies DefaultTheme.NavItemWithLink[]
 }
 
-function pluginsItems(prefix: string): DefaultTheme.NavItemWithLink[] {
+function pluginsItems(prefix: string) {
   return [
     { text: 'Overview', link: `${prefix}/plugins/` },
     { text: 'Devframe Inspector', link: `${prefix}/plugins/inspect` },
     { text: 'Accessibility Inspector', link: `${prefix}/plugins/a11y` },
     { text: 'Git', link: `${prefix}/plugins/git` },
     { text: 'Terminals', link: `${prefix}/plugins/terminals` },
     { text: 'Code Server', link: `${prefix}/plugins/code-server` },
-  ]
+  ] satisfies DefaultTheme.NavItemWithLink[]
 }
 
-function examplesItems(prefix: string): DefaultTheme.NavItemWithLink[] {
+function examplesItems(prefix: string) {
   return [
     { text: 'Overview', link: `${prefix}/examples/` },
+    { text: 'Built with Devframe', link: `${prefix}/examples/built-with` },
     { text: 'files-inspector', link: `${prefix}/examples/files-inspector` },
     { text: 'streaming-chat', link: `${prefix}/examples/streaming-chat` },
     { text: 'next-runtime-snapshot', link: `${prefix}/examples/next-runtime-snapshot` },
     { text: 'minimal-vite-devframe-hub', link: `${prefix}/examples/minimal-vite-devframe-hub` },
     { text: 'minimal-next-devframe-hub', link: `${prefix}/examples/minimal-next-devframe-hub` },
-  ]
+  ] satisfies DefaultTheme.NavItemWithLink[]
 }
 
 export function devframeSidebar(prefix = ''): DefaultTheme.SidebarItem[] {
@@ -104,31 +103,33 @@ export function devframeSidebar(prefix = ''): DefaultTheme.SidebarItem[] {
       text: 'Examples',
       items: examplesItems(prefix),
     },
-    {
-      text: 'Error Reference',
-      link: `${prefix}/errors/`,
-      collapsed: true,
-      items: listErrorCodes('DF').map(code => ({
-        text: code,
-        link: `${prefix}/errors/${code}`,
-      })),
-    },
   ]
 }
 
 export function devframeNav(prefix = ''): DefaultTheme.NavItem[] {
   return [
     { text: 'Guide', items: guideItems(prefix) },
     { text: 'Adapters', items: adaptersItems(prefix) },
-    { text: 'Helpers', items: helpersItems(prefix) },
-    { text: 'Plugins', items: pluginsItems(prefix) },
-    { text: 'Examples', items: examplesItems(prefix) },
+    {
+      text: 'Resources',
+      items: [
+        { text: 'Examples', link: `${prefix}/examples/` },
+        { text: 'Built with Devframe', link: `${prefix}/examples/built-with` },
+        { text: 'Helpers', items: helpersItems(prefix) },
+        { text: 'Plugins', items: pluginsItems(prefix) },
+      ],
+    },
     { text: 'Errors', link: `${prefix}/errors/` },
     {
       text: `v${pkg.version}`,
       items: [
         { text: 'Release Notes', link: `${repo}/releases` },
         { text: 'Contributing', link: `${repo}/blob/main/CONTRIBUTING.md` },
+        {
+          items: [
+            { text: 'Migrating to 0.6', link: `${prefix}/guide/migration-0.6` },
+          ],
+        },
       ],
     },
   ]
@@ -146,7 +147,20 @@ export default withMermaid(defineConfig({
   themeConfig: {
     logo: { light: '/logo.svg', dark: '/logo.svg' },
     nav: devframeNav(),
-    sidebar: devframeSidebar(),
+    sidebar: {
+      '/': devframeSidebar(),
+      '/errors/': [
+        {
+          text: 'Error Reference',
+          link: '/errors/',
+          collapsed: true,
+          items: listErrorCodes('DF').map(code => ({
+            text: code,
+            link: `/errors/${code}`,
+          })),
+        },
+      ],
+    },
     search: {
       provider: 'local',
     },

docs/guide/built-with.md docs/examples/built-with.mddocs/guide/built-with.md renamed to docs/examples/built-with.md

@@ -14,12 +14,6 @@ End-to-end examples that exercise the full adapter surface, each a runnable app
 | [minimal-vite-devframe-hub](./minimal-vite-devframe-hub) | Vanilla TypeScript (Vite) | A ~120-line Vite host wiring `@devframes/hub` end to end. |
 | [minimal-next-devframe-hub](./minimal-next-devframe-hub) | React (Next.js) | The same hub protocol, hosted from a Next.js route handler. |
 
-## Two kinds of example
-
-The first three are **single-tool devframes** — one `DevframeDefinition` deployed through the [adapters](/adapters/), showing how RPC, streaming, and a chosen SPA framework fit together.
-
-The last two are **hub hosts** built on [`@devframes/hub`](/guide/hub). They are protocol witnesses: each is a small host that exercises every hub subsystem (docks, commands, messages, terminals) so you can read one file and see the whole shape. One is a Vite plugin; the other a Next.js route handler — same hub, different host runtime.
-
 ## Run any example
 
 Each example ships its own scripts; from the repository root:

docs/examples/index.md

@@ -2,13 +2,10 @@
 outline: deep
 ---
 
-# Hub (multi-tool)
+# Hub
 
 `@devframes/hub` extends devframe with the orchestration features that only make sense when many devtools share a UI: a dock registry, terminal aggregation, message/toast queue, and a command palette. It does not ship UI — each framework kit (e.g. `@vitejs/devtools-kit`) provides its own UI on top of the hub's RPC + shared-state protocol.
 
-> [!WARNING] Experimental
-> The hub API surface is still being refined. Names may change before 1.0.
-
 ## What the hub adds
 
 A hub-aware node context (`DevframeHubContext`) extends `DevframeNodeContext` with four subsystems:

docs/guide/hub.md

@@ -8,9 +8,6 @@ outline: deep
 
 [Vite DevTools](https://devtools.vite.dev/) is built on top of devframe. If you need an integrated multi-tool host (docks, command palette, terminals, cross-tool toasts), mount your devframe into Vite DevTools via the [`vite` adapter](/adapters/vite) — or build your own host adapter targeting any environment you like.
 
-> [!WARNING] Experimental
-> The Devframe API is still in development and may change between versions. The agent-native surface (`agent` on `defineRpcFunction`, `ctx.agent`, and the MCP adapter) is additionally flagged as experimental.
-
 ## Design principles
 
 Devframe keeps its surface focused on one tool, so the same definition stays portable across runtimes: