fix(docs): commit pre-built docs for Vercel deployment

shtse8 · shtse8 · commit 18874f714794 · 2025-12-17T17:40:36.000Z
@sylphx/leaf package lacks CLI binary, preventing dynamic builds.
Workaround: commit pre-built docs/dist and skip build on Vercel.

Changes:
- Remove docs/dist from .gitignore
- Set buildCommand to empty in vercel.json
- Update docs scripts to use vite directly (for local dev)
- Add root and build.outDir to vite.config.docs.ts
diff --git a/.gitignore b/.gitignore
@@ -6,7 +6,6 @@ coverage/
 .env*
 
 # Leaf
-docs/dist
 docs/.leaf
 public/search-index.json
 
diff --git a/docs/dist/assets/index-5PGWHWJe.js b/docs/dist/assets/index-5PGWHWJe.js
diff --git a/docs/dist/assets/index-ndDgOBBx.css b/docs/dist/assets/index-ndDgOBBx.css
diff --git a/docs/dist/index.html b/docs/dist/index.html
@@ -0,0 +1,57 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<!-- Basic meta tags (will be overridden by config) -->
+		<meta charset="UTF-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+		<meta name="theme-color" content="#15803D" />
+		<meta name="msapplication-TileColor" content="#15803D" />
+
+		<!-- Favicon (will be overridden by config) -->
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<link rel="icon" href="/favicon.png" sizes="32x32" type="image/png" />
+
+		<!-- Default title and description (will be overridden by config) -->
+		<title>Loading...</title>
+		<meta name="description" content="Documentation site built with Leaf" />
+
+		<!-- Default Open Graph tags (will be overridden by config) -->
+		<meta property="og:type" content="website" />
+		<meta property="og:title" content="Leaf" />
+		<meta property="og:description" content="Documentation site built with Leaf" />
+		<meta property="og:site_name" content="Leaf" />
+		<meta property="og:image" content="/og-image.svg" />
+		<meta property="og:image:width" content="1200" />
+		<meta property="og:image:height" content="630" />
+
+		<!-- Default Twitter Card tags (will be overridden by config) -->
+		<meta name="twitter:card" content="summary_large_image" />
+		<meta name="twitter:title" content="Leaf" />
+		<meta name="twitter:description" content="Documentation site built with Leaf" />
+		<meta name="twitter:image" content="/twitter-image.svg" />
+		<meta name="twitter:site" content="@sylphxltd" />
+
+		<!-- SEO tags (will be overridden by config) -->
+		<meta name="keywords" content="documentation, docs, framework" />
+		<meta name="author" content="Sylphx" />
+		<meta name="robots" content="index, follow" />
+		<meta name="language" content="en" />
+		<link rel="canonical" href="https://leaf.sylphx.com" />
+		<script>
+			// CRITICAL: Set theme BEFORE any rendering to prevent flash
+			(() => {
+				const stored = localStorage.getItem('leaf-theme');
+				const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+				const theme = stored || (prefersDark ? 'dark' : 'light');
+				document.documentElement.setAttribute('data-theme', theme);
+			})();
+		</script>
+		<script type="module" crossorigin src="/assets/index-5PGWHWJe.js"></script>
+		<link rel="stylesheet" crossorigin href="/assets/index-ndDgOBBx.css">
+	</head>
+	<body>
+		<div id="root"></div>
+
+		<!-- Mermaid initialization -->
+	</body>
+</html>
diff --git a/docs/dist/logo.svg b/docs/dist/logo.svg
@@ -0,0 +1,5 @@
+<!-- Placeholder Logo -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <rect width="100" height="100" fill="#cccccc"/>
+  <text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-size="12" fill="#333333">LOGO</text>
+</svg>
diff --git a/docs/dist/search-index.json b/docs/dist/search-index.json
@@ -0,0 +1 @@
+[]
diff --git a/package.json b/package.json
@@ -58,9 +58,9 @@
     "check": "biome check .",
     "check:fix": "biome check --write .",
     "validate": "bun run check && bun run test",
-    "docs:dev": "bunx @sylphx/leaf dev docs",
-    "docs:build": "bunx @sylphx/leaf build docs",
-    "docs:preview": "bunx @sylphx/leaf preview docs",
+    "docs:dev": "vite --config vite.config.docs.ts",
+    "docs:build": "vite build --config vite.config.docs.ts",
+    "docs:preview": "vite preview --config vite.config.docs.ts",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
     "benchmark": "bun bench",
diff --git a/vercel.json b/vercel.json
@@ -1,6 +1,5 @@
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "buildCommand": "bun run docs:build",
-  "outputDirectory": "docs/dist",
-  "installCommand": "bun install"
+  "buildCommand": "",
+  "outputDirectory": "docs/dist"
 }
diff --git a/vite.config.docs.ts b/vite.config.docs.ts
@@ -5,6 +5,7 @@ import { defineConfig } from 'vite';
 const docsDir = resolve(process.cwd(), 'docs');
 
 export default defineConfig({
+  root: docsDir,
   plugins: [
     routesPlugin(docsDir),
     ...createLeafPlugin({
@@ -16,4 +17,8 @@ export default defineConfig({
   resolve: {
     dedupe: ['solid-js', 'solid-js/web'],
   },
+  build: {
+    outDir: resolve(process.cwd(), 'docs/dist'),
+    emptyOutDir: true,
+  },
 });

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://openapi.vercel.sh/vercel.json",`
`3`		`- "buildCommand": "bun run docs:build",`
`4`		`- "outputDirectory": "docs/dist",`
`5`		`- "installCommand": "bun install"`
	`3`	`+ "buildCommand": "",`
	`4`	`+ "outputDirectory": "docs/dist"`
`6`	`5`	`}`