kobaltedev · jer3m01 · Mar 18, 2026 · Aug 17, 2025 · Aug 17, 2025 · Aug 23, 2025
diff --git a/.github/workflows/cr.yml b/.github/workflows/cr.yml
@@ -0,0 +1,38 @@
+name: ⚡️ Continuous Releases
+
+on:
+  push:
+    branches:
+      - main
+  merge_group:
+  pull_request:
+
+jobs:
+  cr:
+    name: "⚡️ Continuous Releases"
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+
+      - name: Use Node.js 22.14.0
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.14.0
+          registry-url: "https://registry.npmjs.org"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build start
+        run: pnpm run build
+
+      - name: Rewrite exports
+        run: echo $(cat package.json | jq '.exports = .publishConfig.exports') > package.json
+
+      - name: Release
+        run: pnpm dlx pkg-pr-new@0.0 publish
diff --git a/.github/workflows/format-files.yml b/.github/workflows/format-files.yml
@@ -26,7 +26,7 @@ jobs:
       - name: Setup Biome
         uses: biomejs/setup-biome@v2
         with:
-          version: 1.9.2
+          version: 2.4.7
 
       - name: Run Biome
         run: biome ci .
diff --git a/.prettierignore b/.prettierignore
@@ -5,5 +5,6 @@
 *.json
 *.cjs
 *.css
+*.d.ts
 pnpm-lock.yaml
 examples/solid-docs
diff --git a/biome.json b/biome.json
@@ -1,12 +1,15 @@
 {
 	"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
 	"files": {
-		"ignore": [
-			"./tsconfig.json",
-			"*/netlify/*",
-			"**/package.json",
-			"./examples/solid-docs",
-			"**/app.config.*.js"
+		"includes": [
+			"**",
+			"!./tsconfig.json",
+			"!*/netlify/*",
+			"!**/package.json",
+			"!./examples/solid-docs",
+			"!**/app.config.*.js",
+			"!**/*.d.ts",
+			"!node_modules"
 		]
 	},
 	"vcs": {
@@ -30,7 +33,8 @@
 				"noAssignInExpressions": "off"
 			},
 			"style": {
-				"noNonNullAssertion": "off"
+				"noNonNullAssertion": "off",
+				"noDescendingSpecificity": "off"
 			},
 			"complexity": {
 				"noBannedTypes": "off"

diff --git a/dev/app.config.ts b/dev/app.config.ts
@@ -1,24 +1,24 @@
-import { defineConfig } from "@solidjs/start/config";
-
-import { createWithSolidBase, defineTheme } from "../src/config";
+import { createSolidBase, defineTheme } from "../src/config";
 import defaultTheme from "../src/default-theme";
 
-const customTheme = defineTheme({
+const theme = defineTheme({
 	componentsPath: import.meta.resolve("./src/solidbase-theme"),
 	extends: defaultTheme,
 });
 
-export default defineConfig(
-	createWithSolidBase(customTheme)(
-		{
-			ssr: true,
-			server: {
-				prerender: {
-					crawlLinks: true,
-				},
-			},
+const solidBase = createSolidBase(theme);
+
+export default {
+	...solidBase.startConfig({
+		ssr: true,
+	}),
+	server: {
+		prerender: {
+			crawlLinks: true,
 		},
-		{
+	},
+	plugins: [
+		solidBase.plugin({
 			title: "SolidBase",
 			description:
 				"Fully featured, fully customisable static site generation for SolidStart",
@@ -30,12 +30,10 @@ export default defineConfig(
 					transform: (_code, id) => {
 						let code = _code;
 
-						// tests id
 						if (id.endsWith("to-transform.tsx")) {
 							code += "// appended by transform";
 						}
 
-						// tests code
 						return code.replace("REPLACE ME", "replaced string!");
 					},
 				},
@@ -108,6 +106,6 @@ export default defineConfig(
 					],
 				},
 			},
-		},
-	),
-);
+		}),
+	],
+};
diff --git a/dev/package.json b/dev/package.json
@@ -3,21 +3,23 @@
   "type": "module",
   "private": "true",
   "scripts": {
-    "dev": "VITE_SOLIDBASE_DEV=1 vinxi dev",
-    "build": "vinxi build",
-    "start": "vinxi start"
+    "dev": "cross-env VITE_SOLIDBASE_DEV=true vite dev",
+    "build": "vite build",
+    "preview": "vite preview"
   },
   "dependencies": {
     "@kobalte/solidbase": "workspace:*",
     "@solidjs/router": "^0.15.3",
-    "@solidjs/start": "^1.1.1",
-    "solid-js": "^1.9.5",
-    "vinxi": "^0.5.3"
+    "@solidjs/start": "https://pkg.pr.new/solidjs/solid-start/@solidjs/start@2080",
+    "nitro": "3.0.260311-beta",
+    "solid-js": "^1.9.9"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.12"
   },
   "devDependencies": {
-    "@iconify-json/ri": "^1.2.5"
+    "@iconify-json/ri": "^1.2.5",
+    "cross-env": "^7.0.3",
+    "vite": "^8.0.0"
   }
 }
diff --git a/dev/src/entry-client.tsx b/dev/src/entry-client.tsx
@@ -1,4 +1,4 @@
 // @refresh reload
-import { StartClient, mount } from "@solidjs/start/client";
+import { mount, StartClient } from "@solidjs/start/client";
 
 mount(() => <StartClient />, document.getElementById("app")!);
diff --git a/dev/src/entry-server.tsx b/dev/src/entry-server.tsx
@@ -1,6 +1,6 @@
 import { getHtmlProps } from "@kobalte/solidbase/server";
 // @refresh reload
-import { StartServer, createHandler } from "@solidjs/start/server";
+import { createHandler, StartServer } from "@solidjs/start/server";
 
 export default createHandler(() => (
 	<StartServer

diff --git a/dev/src/routes/about.mdx b/dev/src/routes/about.mdx
@@ -1,5 +1,7 @@
 ---
 title: About
+llms:
+  exclude: true
 ---
 
 # About Page

diff --git a/dev/src/routes/dave.mdx b/dev/src/routes/dave.mdx
@@ -1,5 +1,6 @@
 ---
 title: What are we missing?
+description: This is a test page
 ---
 
 Title as defined by frontmatter: {frontmatter.title}

diff --git a/dev/src/routes/to-transform.tsx b/dev/src/routes/to-transform.tsx
@@ -1,2 +1,2 @@
 // i've not got a title!
-const replacedString = "REPLACE ME";
+const _replacedString = "REPLACE ME";
diff --git a/dev/src/solidbase-theme/Layout.tsx b/dev/src/solidbase-theme/Layout.tsx
@@ -1,6 +1,5 @@
-import { Title } from "@solidjs/meta";
-
 import Layout from "@kobalte/solidbase/default-theme/Layout.jsx";
+import { Title } from "@solidjs/meta";
 import type { ParentProps } from "solid-js";
 
 export default function (props: ParentProps) {

diff --git a/dev/tsconfig.json b/dev/tsconfig.json
@@ -1,19 +1,18 @@
 {
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "jsx": "preserve",
-    "jsxImportSource": "solid-js",
-    "allowJs": true,
-    "strict": true,
-    "noEmit": true,
-    "types": ["vinxi/types/client"],
-    "isolatedModules": true,
-    "paths": {
-      "~/*": ["./src/*"]
-    }
-  }
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"allowSyntheticDefaultImports": true,
+		"esModuleInterop": true,
+		"jsx": "preserve",
+		"jsxImportSource": "solid-js",
+		"allowJs": true,
+		"strict": true,
+		"noEmit": true,
+		"isolatedModules": true,
+		"paths": {
+			"~/*": ["./src/*"]
+		}
+	}
 }
diff --git a/dev/vite.config.mts b/dev/vite.config.mts
@@ -0,0 +1,39 @@
+import { solidStart } from "@solidjs/start/config";
+import { nitro } from "nitro/vite";
+import { defineConfig } from "vite";
+
+import { createSolidBase, defineTheme } from "../src/config";
+import { createFilesystemSidebar } from "../src/config/sidebar";
+import defaultTheme from "../src/default-theme";
+
+const theme = defineTheme({
+	componentsPath: import.meta.resolve("./src/solidbase-theme"),
+	extends: defaultTheme,
+});
+
+const solidBase = createSolidBase(theme);
+
+export default defineConfig({
+	plugins: [
+		solidBase.plugin({
+			title: "SolidBase Dev",
+			description: "Development playground for the latest SolidBase features",
+			llms: true,
+			lang: "en",
+			themeConfig: {
+				sidebar: {
+					"/": createFilesystemSidebar("./src/routes", {
+						filter: (item) => {
+							if ("items" in item) return true;
+							return /\.(md|mdx)$/.test(item.filePath);
+						},
+					}),
+				},
+			},
+		}),
+		solidStart(solidBase.startConfig()),
+		nitro({
+			prerender: { crawlLinks: true },
+		}),
+	],
+});
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -5,6 +5,8 @@ dist
 .vercel
 .netlify
 .vinxi
+.nitro
+.solid-start
 app.config.timestamp_*.js
 
 # Environment

diff --git a/docs/package.json b/docs/package.json
@@ -3,20 +3,20 @@
   "type": "module",
   "private": "true",
   "scripts": {
-    "dev": "cross-env NODE_OPTIONS=\"--max-old-space-size=8192\" VITE_SOLIDBASE_DEV=true vinxi dev",
-    "build": "cross-env NODE_OPTIONS=\"--max-old-space-size=8192\" vinxi build",
-    "start": "vinxi start"
+    "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"
   },
   "dependencies": {
     "@kobalte/solidbase": "workspace:*",
     "@solid-mediakit/og": "0.4.1",
     "@solidjs/router": "^0.15.3",
-    "@solidjs/start": "^1.1.3",
-    "solid-js": "^1.9.5",
-    "vinxi": "^0.5.3"
+    "@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"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.12"
   },
   "devDependencies": {
     "@iconify-json/ri": "^1.2.5",

diff --git a/docs/src/entry-client.tsx b/docs/src/entry-client.tsx
@@ -1,4 +1,4 @@
 // @refresh reload
-import { StartClient, mount } from "@solidjs/start/client";
+import { mount, StartClient } from "@solidjs/start/client";
 
 mount(() => <StartClient />, document.getElementById("app")!);
diff --git a/docs/src/entry-server.tsx b/docs/src/entry-server.tsx
@@ -1,7 +1,7 @@
 import { getFontPreloadLinkAttrs } from "@kobalte/solidbase/default-theme/fonts.js";
 import { getHtmlProps } from "@kobalte/solidbase/server";
 // @refresh reload
-import { StartServer, createHandler } from "@solidjs/start/server";
+import { createHandler, StartServer } from "@solidjs/start/server";
 
 export default createHandler(() => (
 	<StartServer

diff --git a/docs/src/routes/guide/(1)add-to-existing.mdx b/docs/src/routes/guide/(1)add-to-existing.mdx
@@ -87,5 +87,5 @@ To account for this, this small script will automatically be injected to correct
 ## Done!
 
 Your project is now setup with the default SolidBase theme!
-You can now create Markdown routes in your project that take advantage of SolidBase's [Markdown Extensions](../markdown),
-and customise your project's appearance by [customising the default theme](../extending-themes#extending-the-default-theme) or [creating a new theme](../custom-themes).
+You can now create Markdown routes in your project that take advantage of SolidBase's [Markdown Extensions](/guide/features/markdown),
+and customise your project's appearance by [customising the default theme](/guide/customization/extending-themes#extending-the-default-theme) or [creating a new theme](/guide/customization/custom-themes).
diff --git a/docs/src/routes/guide/(2)config.mdx b/docs/src/routes/guide/(2)config.mdx
@@ -49,6 +49,7 @@ interface SolidBaseConfig<ThemeConfig> {
   description?: string;
   logo?: string;
   issueAutolink?: IssueAutoLinkConfig | false;
+  llms?: boolean;
   lang?: string;
   locales?: Record<string, LocaleConfig<ThemeConfig>>;
   themeConfig?: ThemeConfig;
@@ -78,7 +79,7 @@ There are several options for setting site-wide metadata and behavior. These opt
 ```
 
 :::note
-For multilingual support, you can use the `locales` option to define different configurations for each locale. More details can be found in the [Internationalization guide](/guide/i18n).
+For multilingual support, you can use the `locales` option to define different configurations for each locale. More details can be found in the [Internationalization guide](/guide/features/i18n).
 :::
 
 #### Miscellaneous options
@@ -88,15 +89,19 @@ In addition to setting the site title and description, you can also configure ot
 - `editPath`: A string or function to generate the "Edit this page" link for each page.
 - `lastUpdated`: An object to configure the display of the last updated timestamp on each page. Set to `false` to disable this feature.
 - `issueAutolink`: An object to configure automatic linking of issue references in your markdown content. Set to `false` to disable this feature.
+- `llms`: Set to `true` to emit an `llms.txt` index and markdown copies of your routes for LLM-friendly documentation output.
 
 ```ts title="app.config.ts"
 // ..
 editPath: "https://github.com/[USERNAME]/[REPO]/edit/main/docs/:path"
 lastUpdated: false;
 issueAutolink: "https://github.com/[USERNAME]/[REPO]/issues/:issue"
+llms: true;
 // ..
 ```
 
+See the [LLMs.txt guide](/guide/features/llms) for page-level exclusion and output details.
+
 ### Markdown Configuration
 
 In addition to the default markdown support provided by SolidBase, you can include additional markdown plugins, configurations, and other options through the `markdown` option.
-Original file line number
+Diff line change
@@ Expand Up / @@ -5,5 +5,6 @@ @@
     *.json
     *.cjs
     *.css
+    *.d.ts
     pnpm-lock.yaml
     examples/solid-docs