chore(dev): replace preview fixture with local demo site

Author: evannotfound

.github/workflows/pr-preview-build.yml

@@ -60,8 +60,11 @@ jobs:
       - name: Build Theme Assets
         run: pnpm run build
 
+      - name: Link Local Theme
+        run: node dev/link-theme.mjs
+
       - name: Build Hexo Site
-        run: pnpm run preview:generate -- --output-dir dev/site/public
+        run: pnpm --dir dev/site exec hexo generate
 
       - name: Prepare Vercel Prebuilt Output
         run: |

.gitignore

@@ -29,6 +29,7 @@ yarn.lock
 /.sass-cache
 /dev/site/db.json
 /dev/site/public
+/dev/site/themes
 /dev/site/.source
 /dev/site/node_modules
 /connect.lock

.zed/tasks.json

@@ -17,13 +17,5 @@
     "use_new_terminal": true,
     "reveal": "always",
     "save": "all"
-  },
-  {
-    "label": "Redefine preview generate",
-    "command": "pnpm",
-    "args": ["run", "preview:generate"],
-    "cwd": "$ZED_WORKTREE_ROOT",
-    "reveal": "always",
-    "save": "all"
   }
 ]

AGENTS.md

@@ -18,8 +18,7 @@ This file is for automated coding agents working in this repo.
 - Build CSS only: `pnpm run build:css` (Tailwind CLI).
 - Build JS only: `pnpm run build:js` (minifies into `source/js/build`).
 - Watch CSS: `pnpm run watch:css`.
-- Develop against the current worktree: `pnpm dev`.
-- Generate the preview fixture: `pnpm run preview:generate`.
+- Develop against the local demo site: `pnpm dev`.
 - Pre-commit hook blocks committing build outputs on non-`main`/`dev` branches (see `.husky/pre-commit`).
 - Lint: no npm script or config present; add one if needed.
 - Tests: no test runner configured.
@@ -62,11 +61,11 @@ This file is for automated coding agents working in this repo.
 - Class naming: favor existing kebab-case classes and theme-specific names.
 - Tailwind source lives in `source/css/tailwind.source.css`; never edit the generated file.
 
-## Preview Fixture
+## Demo Site
 - The local Hexo site lives in `dev/site/` and is a private pnpm workspace package.
-- `dev/preview.mjs` runs Hexo against the current theme worktree through an isolated temporary runtime.
+- `dev/dev.mjs` mounts the current theme into the demo site, runs Hexo, and watches CSS changes.
 - Branch-specific validation posts and demo pages belong under `dev/site`.
-- Native dependencies required by the fixture are explicitly allowed in `pnpm-workspace.yaml`.
+- Native dependencies required by the demo site are explicitly allowed in `pnpm-workspace.yaml`.
 
 ## Configuration/Data Flow
 - `_config.yml` is the theme config; new options should be exported in `scripts/config-export.js`.

README.md

@@ -117,31 +117,24 @@ It's very easy to understand.
 ## 🛠️ Theme Development
 
 Open the theme repository itself in your editor. Zed worktrees are independent
-theme checkouts, and each checkout contains the Hexo preview fixture under
-`dev/site`.
+theme checkouts, and each checkout contains the local demo site under `dev/site`.
 
 Install all local dependencies with pnpm:
 
 ```sh
 pnpm install --frozen-lockfile
 ```
 
-Start Hexo with the current theme worktree:
+Start the local demo site with the current theme worktree:
 
 ```sh
 pnpm dev
 ```
 
-Generate the fixture without starting a server:
-
-```sh
-pnpm run preview:generate
-```
-
-Issue-specific posts and demo pages belong under `dev/site` and can be
-committed with the theme branch that needs them. The fixture is excluded from
-the published npm package. npm remains supported for installing the published
-theme; pnpm is the repository development and CI package manager.
+Demo posts and pages belong under `dev/site` and can be committed with the
+theme branch that needs them. The demo site is excluded from the published npm
+package. npm remains supported for installing the published theme; pnpm is the
+repository development and CI package manager.
 
 
 

dev/dev.mjs

@@ -0,0 +1,51 @@
+import path from "path";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { linkTheme } from "./link-theme.mjs";
+
+const SCRIPT_PATH = fileURLToPath(import.meta.url);
+const THEME_ROOT = path.resolve(path.dirname(SCRIPT_PATH), "..");
+const SITE_ROOT = path.join(THEME_ROOT, "dev", "site");
+const HEXO_PATH = path.join(SITE_ROOT, "node_modules", ".bin", "hexo");
+
+const children = [];
+let shuttingDown = false;
+
+const shutdown = (exitCode = 0) => {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  children.forEach((child) => {
+    if (!child.killed) child.kill("SIGTERM");
+  });
+  process.exitCode = exitCode;
+};
+
+const start = (command, args, cwd) => {
+  const child = spawn(command, args, {
+    cwd,
+    env: { ...process.env, HUSKY: "0", NODE_ENV: "development" },
+    stdio: "inherit",
+  });
+  children.push(child);
+  return child;
+};
+
+const main = () => {
+  linkTheme();
+  const hexo = start(HEXO_PATH, ["server", ...process.argv.slice(2)], SITE_ROOT);
+  const css = start("pnpm", ["run", "watch:css"], THEME_ROOT);
+
+  hexo.on("exit", (code) => {
+    if (!shuttingDown) shutdown(code || 0);
+  });
+  css.on("exit", (code) => {
+    if (!shuttingDown && code !== 0) shutdown(code || 1);
+  });
+
+  process.on("SIGINT", () => shutdown());
+  process.on("SIGTERM", () => shutdown());
+
+  console.log("Demo site -> http://127.0.0.1:4000");
+};
+
+main();

dev/link-theme.mjs

@@ -0,0 +1,34 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const SCRIPT_PATH = fileURLToPath(import.meta.url);
+const THEME_ROOT = path.resolve(path.dirname(SCRIPT_PATH), "..");
+const SITE_ROOT = path.join(THEME_ROOT, "dev", "site");
+const THEME_LINK = path.join(SITE_ROOT, "themes", "redefine");
+const THEME_ENTRIES = [
+  "_config.yml",
+  "languages",
+  "layout",
+  "package.json",
+  "scripts",
+  "source",
+];
+
+export const linkTheme = () => {
+  fs.rmSync(THEME_LINK, { recursive: true, force: true });
+  fs.mkdirSync(THEME_LINK, { recursive: true });
+
+  THEME_ENTRIES.forEach((entry) => {
+    const target = path.join(THEME_ROOT, entry);
+    const linkPath = path.join(THEME_LINK, entry);
+    const type = fs.statSync(target).isDirectory()
+      ? process.platform === "win32"
+        ? "junction"
+        : "dir"
+      : "file";
+    fs.symlinkSync(target, linkPath, type);
+  });
+};
+
+if (path.resolve(process.argv[1] || "") === SCRIPT_PATH) linkTheme();