From bede246fa46ffa1b483005dd2a81f4fbef792f07 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 22 Feb 2026 12:21:39 +0000 Subject: [PATCH] docs: add Advanced section and reorganize docs structure Move SSR and Multiple Entrypoints pages from Learn to a new Advanced section. Rename Multiple Entrypoints to "Multiple Entrypoints (SSG)". Update all cross-references to the new paths. https://claude.ai/code/session_01T1KEzmQvC4ohJKhT3k4uDQ --- packages/docs/src/App.tsx | 8 ++++---- packages/docs/src/components/Sidebar/Sidebar.tsx | 11 ++++++++--- packages/docs/src/pages/GettingStarted.mdx | 2 +- .../pages/{learn => advanced}/MultipleEntrypoints.mdx | 2 +- packages/docs/src/pages/{learn => advanced}/SSR.mdx | 0 packages/docs/src/pages/api/EntryDefinition.mdx | 2 +- packages/docs/src/pages/api/FunstackStatic.mdx | 6 +++--- 7 files changed, 18 insertions(+), 13 deletions(-) rename packages/docs/src/pages/{learn => advanced}/MultipleEntrypoints.mdx (99%) rename packages/docs/src/pages/{learn => advanced}/SSR.mdx (100%) diff --git a/packages/docs/src/App.tsx b/packages/docs/src/App.tsx index 9209a96..627cf6f 100644 --- a/packages/docs/src/App.tsx +++ b/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,7 +109,7 @@ export const routes: RouteDefinition[] = [ ), }), route({ - path: "/learn/multiple-entrypoints", + path: "/advanced/multiple-entrypoints", component: ( {defer(, { name: "MultipleEntrypoints" })} @@ -117,7 +117,7 @@ export const routes: RouteDefinition[] = [ ), }), route({ - path: "/learn/ssr", + path: "/advanced/ssr", component: {defer(, { name: "SSR" })}, }), route({ diff --git a/packages/docs/src/components/Sidebar/Sidebar.tsx b/packages/docs/src/components/Sidebar/Sidebar.tsx index cefb5b1..0eaf5fa 100644 --- a/packages/docs/src/components/Sidebar/Sidebar.tsx +++ b/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", }, ], }, diff --git a/packages/docs/src/pages/GettingStarted.mdx b/packages/docs/src/pages/GettingStarted.mdx index c40f04b..8c3f87d 100644 --- a/packages/docs/src/pages/GettingStarted.mdx +++ b/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 diff --git a/packages/docs/src/pages/learn/MultipleEntrypoints.mdx b/packages/docs/src/pages/advanced/MultipleEntrypoints.mdx similarity index 99% rename from packages/docs/src/pages/learn/MultipleEntrypoints.mdx rename to packages/docs/src/pages/advanced/MultipleEntrypoints.mdx index 5a3f223..43acf76 100644 --- a/packages/docs/src/pages/learn/MultipleEntrypoints.mdx +++ b/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`. diff --git a/packages/docs/src/pages/learn/SSR.mdx b/packages/docs/src/pages/advanced/SSR.mdx similarity index 100% rename from packages/docs/src/pages/learn/SSR.mdx rename to packages/docs/src/pages/advanced/SSR.mdx diff --git a/packages/docs/src/pages/api/EntryDefinition.mdx b/packages/docs/src/pages/api/EntryDefinition.mdx index 758a142..14127b7 100644 --- a/packages/docs/src/pages/api/EntryDefinition.mdx +++ b/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 diff --git a/packages/docs/src/pages/api/FunstackStatic.mdx b/packages/docs/src/pages/api/FunstackStatic.mdx index 830ae20..abc5851 100644 --- a/packages/docs/src/pages/api/FunstackStatic.mdx +++ b/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