create-volt 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `create-volt` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.39.0] - 2026-06-29
+
+### Fixed
+- **Hot reload now reaches content pages.** Pages/posts are server-rendered HTML
+  that dont load `volt.js`, so the 0.38 morph client never ran on them. In dev,
+  the `pages`/`posts` add-ons now inject the hot-reload client (socket.io +
+  `volt.js`) into every served page. Verified with Chromium: editing a post
+  morphs the DOM in place — scroll position and page state preserved, no full
+  reload. Nothing is injected in production.
+
 ## [0.38.0] - 2026-06-29
 
 ### Added
@@ -508,6 +518,7 @@ All notable changes to `create-volt` are documented here. The format follows
   watching and full-page hot reload. Supports `--skip-install` and `--force`,
   and auto-detects npm / pnpm / yarn / bun for the install step.
 
+[0.39.0]: https://github.com/MIR-2025/volt/releases/tag/v0.39.0
 [0.38.0]: https://github.com/MIR-2025/volt/releases/tag/v0.38.0
 [0.37.0]: https://github.com/MIR-2025/volt/releases/tag/v0.37.0
 [0.36.0]: https://github.com/MIR-2025/volt/releases/tag/v0.36.0

package/addons/pages/files/lib/pages.js

@@ -128,6 +128,13 @@ const DEV = process.env.NODE_ENV !== "production";
 // a restart (ESM caches a given URL forever); unchanged files keep the same URL.
 const freshUrl = (f) => pathToFileURL(f).href + (DEV ? "?t=" + fs.statSync(f).mtimeMs : "");
 
+// In dev, inject the hot-reload client into served pages — content pages don't
+// otherwise load volt.js, so they'd never receive reload/morph events. socket.io
+// serves its client at /socket.io/socket.io.js; volt.js (a module) runs the
+// hot-reload IIFE. Nothing is injected in production.
+const HOT = DEV ? '\n<script src="/socket.io/socket.io.js"></script><script type="module" src="/volt.js"></script>\n' : "";
+export const injectHot = (html) => (!HOT ? html : html.includes("</body>") ? html.replace("</body>", HOT + "</body>") : html + HOT);
+
 export async function loadTheme(dir, env) {
   const wrap = (m) => {
     const layout = m && (m.layout || m.default);
@@ -182,7 +189,7 @@ export async function pagesRouter({ dir }) {
     const content = meta.format === "html" ? body : marked.parse(body);
     const m = { ...meta, title: meta.title || slug };
     const { layout } = await getTheme();
-    res.type("html").send(layout({ title: m.title, head: metaHead(m), content, meta: m }));
+    res.type("html").send(injectHot(layout({ title: m.title, head: metaHead(m), content, meta: m })));
   });
   return r;
 }

package/addons/posts/files/lib/posts.js

@@ -6,7 +6,7 @@ import fs from "node:fs";
 import path from "node:path";
 // express + marked are imported lazily in postsRouter() so the pure helpers load
 // without those deps. Theme + SEO come from the pages add-on (a dependency).
-import { parseFrontMatter, isSafeSlug, metaHead, themeResolver } from "../../../pages/files/lib/pages.js";
+import { parseFrontMatter, isSafeSlug, metaHead, themeResolver, injectHot } from "../../../pages/files/lib/pages.js";
 
 const esc = (s) => String(s).replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
 const slugify = (s) => String(s).toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
@@ -120,7 +120,7 @@ export async function postsRouter({ dir, themeDir }) {
   const render = async ({ title, content, meta = {} }) => {
     const m = { ...meta, title };
     const { layout } = await getTheme();
-    return layout({ title, head: metaHead(m), content, meta: m });
+    return injectHot(layout({ title, head: metaHead(m), content, meta: m }));
   };
   const r = express.Router();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-volt",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Scaffold a new Volt app — no-build, signals-based UI with Socket.io hot reload.",
   "type": "module",
   "bin": {