From e31330c4e697e75a619832b51999b3ebe481c7ba Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 28 Jun 2026 03:36:41 +0000 Subject: [PATCH] docs: remove fsRoutes ssr:true dev-server restriction notes The dev-server limitation tracked in #124 has been lifted, so fsRoutes no longer requires ssr:true to render pages in vite dev. Reframe the ssr guidance as an optional recommendation (SEO, faster initial load) and drop the #124 reference. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01WYLKPC9rXbCVyDMGawSrak --- packages/docs/src/pages/api/FunstackStatic.mdx | 4 ++-- packages/docs/src/pages/learn/FileSystemRouting.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/docs/src/pages/api/FunstackStatic.mdx b/packages/docs/src/pages/api/FunstackStatic.mdx index 87f6194..80e15f0 100644 --- a/packages/docs/src/pages/api/FunstackStatic.mdx +++ b/packages/docs/src/pages/api/FunstackStatic.mdx @@ -80,7 +80,7 @@ export default defineConfig({ }); ``` -`ssr: true` is required for the dev server to render pages. See [File-System Routing](/learn/file-system-routing) for a full guide. +`ssr` is optional here, but enabling it (`ssr: true`) is recommended for SEO and faster initial load. See [File-System Routing](/learn/file-system-routing) for a full guide. ## Options @@ -215,7 +215,7 @@ funstackStatic({ - **`root`** (required) — path to the root (HTML shell) component module. - **`adapter`** (required) — a module that `export default`s an `FsRoutesAdapter`, given as a bare module specifier or a path relative to the Vite root. Use the bundled `@funstack/static/fs-routes/next-adapter` for the built-in Next.js-like convention, or point it at your own module for a custom one. -Enable [`ssr`](#ssr-optional) alongside `fsRoutes` — it is required for the dev server to render pages and recommended in general. +Enabling [`ssr`](#ssr-optional) alongside `fsRoutes` is optional but recommended for SEO and faster initial load. See [File-System Routing](/learn/file-system-routing) for the conventions, dynamic routes, and writing custom adapters. diff --git a/packages/docs/src/pages/learn/FileSystemRouting.mdx b/packages/docs/src/pages/learn/FileSystemRouting.mdx index eed6df6..19fa6ca 100644 --- a/packages/docs/src/pages/learn/FileSystemRouting.mdx +++ b/packages/docs/src/pages/learn/FileSystemRouting.mdx @@ -47,7 +47,7 @@ All `fsRoutes` fields are required, so each choice is explicit in your config: `fsRoutes` is mutually exclusive with the `root` + `app` (single-entry) and `entries` (multiple entries) modes. -> **Enable [`ssr`](/api/funstack-static).** Pages are server components rendered through FUNSTACK Router. `ssr: true` is **required for the dev server** (`vite dev`) to render your pages — without it, the dev server can only render the app shell — and it is recommended in general for SEO and faster initial load. Production builds work with `ssr` either way. Lifting this dev-server requirement is tracked in [#124](https://github.com/uhyo/funstack-static/issues/124). +> **Consider enabling [`ssr`](/api/funstack-static).** Pages are server components rendered through FUNSTACK Router. `ssr` is optional and works the same in dev (`vite dev`), production builds, and preview either way, but enabling it (`ssr: true`) is recommended for SEO and faster initial load. ## The Next.js-like Convention