docs: apply review feedback

- Restore the Nitro, Nuxt, and SvelteKit mount examples in the standard
  handler page.
- Rename the guide nav group to 'Agentic'.
- Drop the deprecated `def.cli?.distDir` fallback note from the build adapter.
- Consolidate examples into a single guide/built-with page (Real-world
  DevTools / Builtin Plugins / Playable Examples) and remove the per-example
  docs pages; example READMEs serve that purpose. Repoint links accordingly.
- Rework the Introduction to lead with what Devframe is, why it exists, and
  who it is for before the technical details.

Created with the help of an agent.

Author: antfubot

docs/.vitepress/config.ts

@@ -50,7 +50,7 @@ function guideGroups(prefix: string) {
       ],
     },
     {
-      text: 'Visual & agentic',
+      text: 'Agentic',
       items: [
         { text: 'Agent-Native', link: `${prefix}/guide/agent-native` },
       ],
@@ -73,6 +73,12 @@ function guideGroups(prefix: string) {
         { text: 'Build Your Own Hub UI', link: `${prefix}/guide/build-your-own-hub-ui` },
       ],
     },
+    {
+      text: 'Ecosystem',
+      items: [
+        { text: 'Built with Devframe', link: `${prefix}/guide/built-with` },
+      ],
+    },
   ] satisfies { text: string, items: DefaultTheme.NavItemWithLink[] }[]
 }
 
@@ -121,27 +127,6 @@ function pluginsItems(prefix: string) {
   ] satisfies 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: 'json-render', link: `${prefix}/examples/json-render` },
-    { text: 'streaming-chat', link: `${prefix}/examples/streaming-chat` },
-    { text: 'next-runtime-snapshot', link: `${prefix}/examples/next-runtime-snapshot` },
-    { text: 'hub-vite', link: `${prefix}/examples/hub-vite` },
-    { text: 'hub-next', link: `${prefix}/examples/hub-next` },
-    { text: 'hub-vite-minimal', link: `${prefix}/examples/hub-vite-minimal` },
-    { text: 'hub-next-minimal', link: `${prefix}/examples/hub-next-minimal` },
-    { text: 'hub-nitro-minimal', link: `${prefix}/examples/hub-nitro-minimal` },
-    { text: 'hub-hono-minimal', link: `${prefix}/examples/hub-hono-minimal` },
-    { text: 'hub-fastify-minimal', link: `${prefix}/examples/hub-fastify-minimal` },
-    { text: 'hub-sveltekit-minimal', link: `${prefix}/examples/hub-sveltekit-minimal` },
-    { text: 'hub-deno-minimal', link: `${prefix}/examples/hub-deno-minimal` },
-    { text: 'hub-rsbuild-minimal', link: `${prefix}/examples/hub-rsbuild-minimal` },
-  ] satisfies DefaultTheme.NavItemWithLink[]
-}
-
 export function devframeSidebar(prefix = ''): DefaultTheme.SidebarItem[] {
   return [
     {
@@ -165,10 +150,6 @@ export function devframeSidebar(prefix = ''): DefaultTheme.SidebarItem[] {
       text: 'Plugins',
       items: pluginsItems(prefix),
     },
-    {
-      text: 'Examples',
-      items: examplesItems(prefix),
-    },
   ]
 }
 

docs/adapters/build.md

@@ -23,7 +23,7 @@ await createBuild(devframe, {
 | Option | Default | Description |
 |--------|---------|-------------|
 | `outDir` | `dist-static` | Output directory (cleared). |
-| `distDir` | `def.clientAssets` (deprecated `def.cli?.distDir` fallback) | SPA dist override (or [remote assets](/guide/client-assets)). |
+| `distDir` | `def.clientAssets` | SPA dist override (or [remote assets](/guide/client-assets)). |
 | `pretty` | `false` | Pretty-print dump JSON. |
 
 The client runs read-only. For a custom URL base, build with relative asset paths (`vite.base: './'`).

docs/adapters/initiate.md

@@ -40,6 +40,16 @@ export default defineConfig({
 })
 ```
 
+```ts [Nitro]
+// routes/__my-tool/[...path].ts
+// routes/__my-tool/index.ts
+// for the namespace root, since a catch-all doesn't match its own empty path.
+import { defineHandler } from 'nitro'
+import { devtools } from '../../devtools'
+
+export default defineHandler(event => devtools.handler(event.req))
+```
+
 ```ts [Hono]
 // server.ts
 // `serve()` hands back the node server the socket rides on
@@ -71,6 +81,31 @@ const devtools = g.devtools ??= initDevframe(myDevframe, {
 export const GET = devtools.handler
 ```
 
+```ts [Nuxt]
+// server/middleware/devtools.ts
+import { devtools } from '../devtools'
+
+export default defineEventHandler((event) => {
+  const { pathname } = new URL(toWebRequest(event).url)
+  // `devtools.base` is the normalized mount base — no repeated string.
+  if (pathname.startsWith(devtools.base) || pathname === devtools.base.slice(0, -1))
+    return devtools.handler(toWebRequest(event))
+})
+```
+
+```ts [SvelteKit]
+// src/routes/%5F_my-tool/[...path]/+server.ts
+import myDevframe from '$lib/devframe'
+import { initDevframe } from 'devframe/initiate'
+
+const g = globalThis as { devtools?: ReturnType<typeof initDevframe> }
+const devtools = g.devtools ??= initDevframe(myDevframe, {
+  base: '/__my-tool/',
+  ws: { sidecar: true },
+})
+export const GET = ({ request }) => devtools.handler(request)
+```
+
 :::
 
 Frameworks with dev-time module reloading (Next, Nitro, SvelteKit) re-evaluate the calling module, so memoize the instance on `globalThis` — otherwise every reload leaks the previous socket. `@devframes/next`'s `createDevframeNextHandler` does this for you.