[feat]: introduce projects, versioning

dev/src/routes/es/index.mdx

@@ -0,0 +1,11 @@
+---
+title: SolidBase en español
+---
+
+# SolidBase en español
+
+Spanish content is valid for the default project on the latest version.
+
+[English](/)
+
+[French](/fr)

dev/src/routes/fr/index.mdx

@@ -0,0 +1,13 @@
+---
+title: SolidBase en français
+---
+
+# SolidBase en français
+
+French content for the default project and latest version.
+
+[English](/)
+
+[Legacy French](/v1/fr)
+
+[Router French](/router/fr)

dev/src/routes/index.mdx

@@ -66,6 +66,26 @@ www.example.com
 
 [Link internal /about](/about)
 
+## Route config demo
+
+[Latest English](/)
+
+[Latest French](/fr)
+
+[Latest Spanish](/es)
+
+[Legacy English](/v1)
+
+[Legacy French](/v1/fr)
+
+[Router English](/router)
+
+[Router French](/router/fr)
+
+[Router French About](/router/fr/about)
+
+[External v0](https://solidbase.dev)
+
 #20 also #4 but no \\#20
 
 A note[^1]

dev/src/routes/router/fr/about.mdx

@@ -0,0 +1,11 @@
+---
+title: Router Demo about en français
+---
+
+# Router Demo about en français
+
+French router content with an extra page route after the route config prefix.
+
+[Router French](/router/fr)
+
+[Router English](/router)

dev/src/routes/router/fr/index.mdx

@@ -0,0 +1,11 @@
+---
+title: Router Demo en français
+---
+
+# Router Demo en français
+
+Router project content for the latest French route.
+
+[SolidBase French](/fr)
+
+[Router English](/router)

dev/src/routes/router/index.mdx

@@ -0,0 +1,11 @@
+---
+title: Router Demo
+---
+
+# Router Demo
+
+Router project content for the latest English route.
+
+[SolidBase English](/)
+
+[Router French](/router/fr)

dev/src/routes/v1/fr/index.mdx

@@ -0,0 +1,11 @@
+---
+title: SolidBase v1 en français
+---
+
+# SolidBase v1 en français
+
+Legacy French content for the default project.
+
+[Latest French](/fr)
+
+[Legacy English](/v1)

dev/src/routes/v1/index.mdx

@@ -0,0 +1,11 @@
+---
+title: SolidBase v1
+---
+
+# SolidBase v1
+
+Legacy English content for the default project.
+
+[Latest English](/)
+
+[Legacy French](/v1/fr)

dev/vite.config.mts

@@ -4,7 +4,10 @@ import { defineConfig } from "vite";
 import Inspect from "vite-plugin-inspect";
 
 import { createSolidBase, defineTheme } from "../src/config";
-import { createFilesystemSidebar } from "../src/config/sidebar";
+import {
+	createFilesystemSidebar,
+	type SidebarItemWithMeta,
+} from "../src/config/sidebar";
 import defaultTheme from "../src/default-theme";
 
 const theme = defineTheme({
@@ -14,6 +17,21 @@ const theme = defineTheme({
 
 const solidBase = createSolidBase(theme);
 
+function getSidebarFileName(item: SidebarItemWithMeta) {
+	const segments = item.filePath.split(/[\\/]/);
+	return segments[segments.length - 1];
+}
+
+function createDevSidebar(route: string, hiddenFolders: string[] = []) {
+	return createFilesystemSidebar(route, {
+		filter: (item) => {
+			if (hiddenFolders.includes(getSidebarFileName(item) ?? "")) return false;
+			if ("items" in item) return true;
+			return /\.(md|mdx)$/.test(item.filePath);
+		},
+	});
+}
+
 export default defineConfig({
 	plugins: [
 		Inspect(),
@@ -22,14 +40,113 @@ export default defineConfig({
 			description: "Development playground for the latest SolidBase features",
 			llms: true,
 			lang: "en",
+			routes: {
+				path: "/{project}/{version}/{locale}",
+				project: {
+					default: "solidbase",
+					values: {
+						solidbase: { path: "", label: "SolidBase" },
+						router: { path: "router", label: "Router Demo" },
+					},
+				},
+				version: {
+					default: "latest",
+					values: {
+						latest: { path: "", label: "Latest" },
+						v1: { path: "v1", label: "v1", status: "Legacy" },
+						v0: { href: "https://solidbase.dev", label: "External v0" },
+					},
+				},
+				locale: {
+					default: "en",
+					values: {
+						en: { path: "", label: "English", lang: "en-US" },
+						fr: { path: "fr", label: "Français", lang: "fr-FR" },
+						es: { path: "es", label: "Español", lang: "es-ES" },
+					},
+				},
+				include: [
+					{
+						project: ["solidbase", "router"],
+						version: "latest",
+						locale: ["en", "fr"],
+					},
+					{
+						project: "solidbase",
+						version: "latest",
+						locale: "es",
+					},
+					{
+						project: "solidbase",
+						version: "v1",
+						locale: ["en", "fr"],
+					},
+				],
+			},
+			overrides: [
+				{
+					locale: "fr",
+					titleTemplate: ":title - Demo SolidBase",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/fr"),
+						},
+					},
+				},
+				{
+					locale: "es",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/es"),
+						},
+					},
+				},
+				{
+					project: "router",
+					title: "Router Demo",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/router", ["fr"]),
+						},
+					},
+				},
+				{
+					version: "v1",
+					title: "SolidBase v1 Demo",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/v1", ["fr"]),
+						},
+					},
+				},
+				{
+					project: "router",
+					locale: "fr",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/router/fr"),
+						},
+					},
+				},
+				{
+					version: "v1",
+					locale: "fr",
+					themeConfig: {
+						sidebar: {
+							"/": createDevSidebar("./src/routes/v1/fr"),
+						},
+					},
+				},
+				{
+					project: "solidbase",
+					version: "v1",
+					locale: "fr",
+					title: "SolidBase v1 en français",
+				},
+			],
 			themeConfig: {
 				sidebar: {
-					"/": createFilesystemSidebar("./src/routes", {
-						filter: (item) => {
-							if ("items" in item) return true;
-							return /\.(md|mdx)$/.test(item.filePath);
-						},
-					}),
+					"/": createDevSidebar("./src/routes", ["es", "fr", "router", "v1"]),
 				},
 			},
 		}),

docs/package.json

@@ -3,8 +3,8 @@
   "type": "module",
   "private": "true",
   "scripts": {
-    "dev": "cross-env NODE_OPTIONS=\"--max-old-space-size=8192\" VITE_SOLIDBASE_DEV=true vite dev",
-    "build": "cross-env NODE_OPTIONS=\"--max-old-space-size=8192\" vite build"
+    "dev": "cross-env VITE_SOLIDBASE_DEV=true vite dev",
+    "build": "cross-env vite build"
   },
   "dependencies": {
     "@kobalte/solidbase": "workspace:*",
@@ -13,7 +13,7 @@
     "@solidjs/start": "https://pkg.pr.new/solidjs/solid-start/@solidjs/start@2080",
     "nitro": "3.0.260311-beta",
     "solid-js": "^1.9.9",
-    "vite": "^8.0.0"
+    "vite": "8.0.0"
   },
   "engines": {
     "node": ">=22.12"

docs/src/routes/fr/guide/markdown.mdx

@@ -0,0 +1,7 @@
+---
+title: Markdown
+---
+
+# Markdown
+
+SolidBase inclut plein de fonctionnalités pour votre markdown.