feat: fs sidebar

Author: jer3m01

docs/app.config.ts

@@ -3,7 +3,8 @@ import { defineConfig } from "@solidjs/start/config";
 import arraybuffer from "vite-plugin-arraybuffer";
 
 import { createWithSolidBase, defineTheme } from "../src/config";
-import defaultTheme from "../src/default-theme";
+import defaultTheme, { DefaultThemeSidebarItem } from "../src/default-theme";
+import { createFilesystemSidebar, SidebarConfig } from "../src/config/sidebar";
 
 const theme = defineTheme({
 	componentsPath: import.meta.resolve("./src/solidbase-theme"),
@@ -97,173 +98,23 @@ export default defineConfig(
 					},
 				],
 				sidebar: {
-					"/guide": [
-						{
-							title: "Overview",
-							collapsed: false,
-							items: [
-								{
-									title: "What is SolidBase?",
-									link: "/",
-								},
-								{
-									title: "Quick Start",
-									link: "/quickstart",
-									status: "new",
-								},
-								{
-									title: "Add to an Existing Project",
-									link: "/add-to-existing",
-								},
-								{
-									title: "Configure Your App",
-									link: "/config",
-								},
-								{
-									title: "Project Structure",
-									link: "/structure",
-								},
-								{
-									title: "Deploy Your Site",
-									link: "/deploy",
-								},
-							],
-						},
-						{
-							title: "Features",
-							collapsed: false,
-							items: [
-								{
-									title: "Markdown Extensions",
-									link: "/markdown",
-								},
-								{
-									title: "Language Switcher",
-									link: "/language-switcher",
-								},
-								{
-									title: "Internationalisation",
-									link: "/i18n",
-								},
-								{
-									title: "Sitemap Generation",
-									link: "/sitemap",
-								},
-								{
-									title: "Dev",
-									link: "/dev",
-								},
-							],
-						},
-						{
-							title: "Customisation",
-							collapsed: false,
-							items: [
-								{
-									title: "Custom Themes",
-									link: "/custom-themes",
-								},
-								{
-									title: "Extending Themes",
-									link: "/extending-themes",
-								},
-							],
-						},
-					],
-					"/reference": [
-						{
-							title: "Reference",
-							collapsed: false,
-							items: [
-								{
-									title: "Configuration Options",
-									link: "/config",
-								},
-								{
-									title: "Frontmatter Config",
-									link: "/frontmatter",
-								},
-								{
-									title: "Runtime API",
-									link: "/runtime-api",
-								},
-							],
-						},
-						{
-							title: "Default Theme",
-							collapsed: false,
-							items: [
-								{
-									title: "Overview",
-									link: "/default-theme",
-								},
-								{
-									title: "CSS Variables",
-									link: "/default-theme/css-variables",
-								},
-								{
-									title: "Components",
-									collapsed: false,
-									items: [
-										{
-											title: "Article",
-											link: "/default-theme/article",
-										},
-										{
-											title: "Features",
-											link: "/default-theme/features",
-										},
-										{
-											title: "Footer",
-											link: "/default-theme/footer",
-										},
-										{
-											title: "Header",
-											link: "/default-theme/header",
-										},
-										{
-											title: "Hero",
-											link: "/default-theme/hero",
-										},
-										{
-											title: "Last Updated",
-											link: "/default-theme/last-updated",
-										},
-										{
-											title: "Link",
-											link: "/default-theme/link",
-										},
-										{
-											title: "Locale Selector",
-											link: "/default-theme/locale-selector",
-										},
-										{
-											title: "Sidebar",
-											link: "/default-theme/sidebar",
-										},
-										{
-											title: "Table of Contents",
-											link: "/default-theme/toc",
-										},
-										{
-											title: "Theme Selector",
-											link: "/default-theme/theme-selector",
-										},
-									],
-								},
-								{
-									title: "Landing",
-									link: "/default-theme/landing",
-								},
-								{
-									title: "Layout",
-									link: "/default-theme/layout",
-								},
-							],
-						},
-					],
+					"/guide": customFSSidebar("/guide", "Overview"),
+					"/reference": customFSSidebar("/reference", "Reference"),
 				},
 			},
 		},
 	),
 );
+
+
+function customFSSidebar(route: string, title: string) {
+	const sidebar = createFilesystemSidebar(route);
+
+	return [
+		{
+			title,
+			items: sidebar.filter((i) => !("items" in i)),
+		},
+		...sidebar.filter((i) => ("items" in i))
+	];
+}

docs/src/routes/guide/quickstart.mdx docs/src/routes/guide/(0)quickstart.mdxdocs/src/routes/guide/quickstart.mdx renamed to docs/src/routes/guide/(0)quickstart.mdx

@@ -235,7 +235,7 @@ nav: [
 The sidebar configuration allows you to create a structured sidebar navigation for different sections of your documentation, with support for collapsible groups and nested items. The value is an array, each containing a title, a collapsed state, and an array of items. Each item can have a title, link, and optional status (`"new"`, `"updated"`, `"next"`).
 
 :::note
-While there are preset statuses available, you can create your own custom status styles. 
+While there are preset statuses available, you can create your own custom status styles.
 
 ```ts title="app.config.ts"
 // ..
@@ -293,20 +293,3 @@ sidebar: {
 },
 // ..
 ```
-
-#### Search
-
-SolidBase includes built-in search functionality. At the moment, it supports [Algolia DocSearch](https://docsearch.algolia.com/). You can configure the search provider and its options using the `search` option within `themeConfig`.
-
-```ts title="app.config.ts"
-// ..
-search: {
-    provider: "algolia",
-    options: {
-        appID: "<YOUR_APP_ID>",
-        apiKey: "<YOUR_API_KEY>"
-        indexName: "<YOUR_INDEX_NAME>"
-    }
-}
-// ..
-```

docs/src/routes/guide/add-to-existing.mdx …/src/routes/guide/(1)add-to-existing.mdxdocs/src/routes/guide/add-to-existing.mdx renamed to docs/src/routes/guide/(1)add-to-existing.mdx docs/src/routes/guide/add-to-existing.mdx renamed to docs/src/routes/guide/(1)add-to-existing.mdx

@@ -1,5 +1,6 @@
 ---
 title: What are we missing?
+excludeFromSidebar: true
 ---
 
 # Day 1088 of asking for an internal shitpost channel