docs: add Advanced section and reorganize docs structure

packages/docs/src/App.tsx

@@ -9,8 +9,8 @@ import LazyServerComponents from "./pages/learn/LazyServerComponents.mdx";
 import OptimizingPayloads from "./pages/learn/OptimizingPayloads.mdx";
 import RSCConcept from "./pages/learn/RSC.mdx";
 import DeferAndActivity from "./pages/learn/DeferAndActivity.mdx";
-import MultipleEntrypoints from "./pages/learn/MultipleEntrypoints.mdx";
-import SSR from "./pages/learn/SSR.mdx";
+import MultipleEntrypoints from "./pages/advanced/MultipleEntrypoints.mdx";
+import SSR from "./pages/advanced/SSR.mdx";
 import EntryDefinitionApi from "./pages/api/EntryDefinition.mdx";
 import FAQ from "./pages/FAQ.mdx";
 import GettingStarted from "./pages/GettingStarted.mdx";
@@ -109,15 +109,15 @@ export const routes: RouteDefinition[] = [
         ),
       }),
       route({
-        path: "/learn/multiple-entrypoints",
+        path: "/advanced/multiple-entrypoints",
         component: (
           <Layout>
             {defer(<MultipleEntrypoints />, { name: "MultipleEntrypoints" })}
           </Layout>
         ),
       }),
       route({
-        path: "/learn/ssr",
+        path: "/advanced/ssr",
         component: <Layout>{defer(<SSR />, { name: "SSR" })}</Layout>,
       }),
       route({

packages/docs/src/components/Sidebar/Sidebar.tsx

@@ -44,13 +44,18 @@ export const navigation: NavSection[] = [
         label: "Prefetching with Activity",
         href: "/learn/defer-and-activity",
       },
+    ],
+  },
+  {
+    title: "Advanced",
+    items: [
       {
-        label: "Multiple Entrypoints",
-        href: "/learn/multiple-entrypoints",
+        label: "Multiple Entrypoints (SSG)",
+        href: "/advanced/multiple-entrypoints",
       },
       {
         label: "Server-Side Rendering",
-        href: "/learn/ssr",
+        href: "/advanced/ssr",
       },
     ],
   },

packages/docs/src/pages/GettingStarted.mdx

@@ -179,5 +179,5 @@ This registers the `funstack-static-knowledge` skill, which provides your AI ass
 
 - Learn about the [funstackStatic() Plugin API](/funstack-static/api/funstack-static) for configuration options
 - Understand [defer()](/funstack-static/api/defer) for Server Component chunk splitting
-- Build multi-page static sites with [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints)
+- Build multi-page static sites with [Multiple Entrypoints](/funstack-static/advanced/multiple-entrypoints)
 - Dive into [React Server Components](/funstack-static/learn/rsc) concepts

packages/docs/src/pages/learn/MultipleEntrypoints.mdx → packages/docs/src/pages/advanced/MultipleEntrypoints.mdx

@@ -1,4 +1,4 @@
-# Multiple Entrypoints
+# Multiple Entrypoints (SSG)
 
 By default, FUNSTACK Static produces a single `index.html` from one `root` + `app` pair. The **multiple entries** feature lets you produce multiple HTML pages from a single project, targeting SSG (Static Site Generation) use cases where a site has distinct pages like `index.html`, `about.html`, and `blog/post-1.html`.
 

packages/docs/src/pages/api/EntryDefinition.mdx

@@ -135,5 +135,5 @@ export default async function* getEntries() {
 
 ## See Also
 
-- [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) - Guide and examples
+- [Multiple Entrypoints](/funstack-static/advanced/multiple-entrypoints) - Guide and examples
 - [funstackStatic()](/funstack-static/api/funstack-static) - Plugin configuration

packages/docs/src/pages/api/FunstackStatic.mdx

@@ -51,7 +51,7 @@ export default defineConfig({
 });
 ```
 
-See [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) for a full guide.
+See [Multiple Entrypoints](/funstack-static/advanced/multiple-entrypoints) for a full guide.
 
 ## Options
 
@@ -158,7 +158,7 @@ export default function getEntries(): EntryDefinition[] {
 }
 ```
 
-See [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) for details on the `EntryDefinition` type and advanced usage patterns like async generators.
+See [Multiple Entrypoints](/funstack-static/advanced/multiple-entrypoints) for details on the `EntryDefinition` type and advanced usage patterns like async generators.
 
 ### publicOutDir (optional)
 
@@ -275,6 +275,6 @@ You can use the same Vite commands you would use in a normal Vite project:
 ## See Also
 
 - [Getting Started](/funstack-static/getting-started) - Quick start guide
-- [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) - Multi-page static site generation
+- [Multiple Entrypoints](/funstack-static/advanced/multiple-entrypoints) - Multi-page static site generation
 - [defer()](/funstack-static/api/defer) - Deferred rendering for streaming
 - [React Server Components](/funstack-static/learn/rsc) - Understanding RSC