Open-Tech-Foundation · github-actions · Jun 25, 2026
diff --git a/.changeset/create-web-minor.md b/.changeset/create-web-minor.md
diff --git a/.changeset/web-cli-minor.md b/.changeset/web-cli-minor.md
diff --git a/.changeset/web-compiler-minor.md b/.changeset/web-compiler-minor.md
diff --git a/.changeset/web-docs-minor.md b/.changeset/web-docs-minor.md
diff --git a/.changeset/web-minor.md b/.changeset/web-minor.md
diff --git a/packages/create-web/CHANGELOG.md b/packages/create-web/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @opentf/create-web
 
+## 0.6.0
+
+### Minor Changes
+
+- 66fecf0: Documentation-site project template.
+
+  - `bun create @opentf/web` now prompts for a project type and can scaffold a docs site powered by `@opentf/web-docs` — navbar, sidebar nav, MDX pages, `global.css`, and a wired-up `otfw.config.js` — alongside the existing app template.
+  - Fix: the docs template's MDX pages import their doc components correctly.
+
 ## 0.5.0
 
 ### Minor Changes

diff --git a/packages/create-web/package.json b/packages/create-web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opentf/create-web",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "The official scaffolding tool for the OTF Web.",
   "bin": {
     "create-web": "./bin/index.js"

diff --git a/packages/web-cli/CHANGELOG.md b/packages/web-cli/CHANGELOG.md
@@ -1,5 +1,24 @@
 # @opentf/web-cli
 
+## 1.1.0
+
+### Minor Changes
+
+- 66fecf0: MDX builds, SSG head/sitemap, docs search indexing, and a phased build UI.
+
+  - Resolve and compile `.mdx`/`.md` modules through `otfwc`'s MDX front-end.
+  - SSG: inject per-route `<head>` from resolved metadata, pre-render dynamic routes, and emit `sitemap.xml` + `robots.txt`.
+  - Docs-site generator integration: a nav plugin builds the sidebar from the docs directory, dedups group landing pages, and honors route exclusions — driven by `otfw.config.js`.
+  - `otfw build --ssg` runs a Pagefind index pass when docs search is configured (`@opentf/web-docs/build`'s `indexWithPagefind`), with live progress.
+  - Phased build output: per-phase spinners with live detail, collapsing to green ✅ lines with elapsed time, ending with `→ dist/ ready in …`; quiet on non-TTY streams.
+  - Silence Rolldown's `PLUGIN_TIMINGS` advisory (the per-file compiler subprocess dominates plugin time by design).
+  - Fix: dev server serves `public/` assets (e.g. `/logo.png`).
+
+### Patch Changes
+
+- Updated dependencies [66fecf0]
+  - @opentf/web-compiler@0.2.0
+
 ## [Unreleased]
 
 ### Added

diff --git a/packages/web-cli/package.json b/packages/web-cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opentf/web-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "OTF Web dev toolchain — the Rolldown-driven CSR dev server, production build, and SSG.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@opentf/web-compiler": "0.1.0",
+    "@opentf/web-compiler": "0.2.0",
     "@tailwindcss/node": "4.2.2",
     "@tailwindcss/oxide": "4.2.2",
     "rolldown": "1.0.0-rc.17",

diff --git a/packages/web-compiler/CHANGELOG.md b/packages/web-compiler/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @opentf/web-compiler
 
+## 0.2.0
+
+### Minor Changes
+
+- 66fecf0: MDX table alignment, heading anchors, and brotli-compressed binaries.
+
+  - MDX: GFM table column alignment — the `:--` / `:-:` / `--:` delimiter row emits inline `text-align` per column.
+  - MDX: each heading emits a self-linking `.otfw-heading-anchor` (aria-hidden, hidden until hover) so sections are shareable.
+  - Prebuilt `otfwc` binaries now ship brotli-compressed (~0.65 MB vs ~2.3 MB raw); a `postinstall` decompresses only the host's binary, with a lazy fallback in `otfwcPath()`. Uses Node's `zlib` (no extra dependency) and yields a byte-identical, runnable binary.
+
 ## [Unreleased]
 
 ### Fixed

diff --git a/packages/web-compiler/package.json b/packages/web-compiler/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opentf/web-compiler",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "OTF Web IR compiler (otfwc) — prebuilt platform binaries + host resolver (ARCHITECTURE.md §8).",
   "private": true,
   "type": "module",

diff --git a/packages/web-docs/CHANGELOG.md b/packages/web-docs/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @opentf/web-docs
 
+## 0.2.0
+
+### Minor Changes
+
+- 66fecf0: Documentation-site theme: search, MDX niceties, and design polish.
+
+  - Pagefind-backed docs search: a ⌘K / Ctrl+K modal that lazy-loads a static index and queries it client-side, with section-level results that deep-link to the matched heading and show each page's breadcrumb trail. Build hook `indexWithPagefind` from `@opentf/web-docs/build`.
+  - Code blocks get a header bar (language label, optional filename, copy button that turns green with a check); a `CodeBlock` component renders the same structure for non-fence code.
+  - `Steps` component (numbered walkthrough); `Tabs` renders `content` as-is and covers the package-manager "code group" pattern (replacing `CodeGroup`). Exports `NavbarLink`, `NavIcon`, `Steps`.
+  - Navbar: active-route underline, per-link icons via a `NavIcon` registry, and a version badge.
+  - Hover `#` heading anchors; aligned Markdown tables.
+  - Design: callout redesign, sidebar dot markers, full h1–h6 prose scale.
+  - Fixes: `Pagination` null crash on the first/last page, prose list markers, GFM task-list styling, copy-button Clipboard-API fallback, sticky `display: contents` navbar host.
+
 ## [Unreleased]
 
 ### Added

diff --git a/packages/web-docs/package.json b/packages/web-docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opentf/web-docs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Documentation-site generator for OTF Web — themed shell components (sidebar, TOC, callouts, tabs), a build-time nav generator, and a default light/dark theme.",
   "type": "module",
   "exports": {

diff --git a/packages/web/CHANGELOG.md b/packages/web/CHANGELOG.md
@@ -1,5 +1,17 @@
 # @opentf/web
 
+## 0.6.0
+
+### Minor Changes
+
+- 66fecf0: SSG SEO/head rendering, MDX routes, and reactivity performance.
+
+  - Per-route SEO metadata + `<head>` rendering (`server/head.js`): Next-style `metadata` / `generateMetadata`, layout-chain merge, and `renderHead` emitting title, description, canonical, robots, Open Graph, Twitter Card, and JSON-LD. `titleTemplate` ("%s — Site") brands child-page titles; `title: { absolute }` opts out.
+  - `RawHtml` built-in (`web-internal-raw-html`) and `.mdx`/`.md` route module support.
+  - Reserved the `web-internal-*` prefix for framework built-ins (Portal, RawHtml) plus an SSG host hook so they pre-render correctly.
+  - Performance: reactive bindings elide no-op writes; keyed list reconciliation does minimal moves instead of re-appending.
+  - Fixes: `router.pathname` drops a trailing slash (so `/docs/x/` matches the route table); forward navigation resets scroll (honoring `#anchor`), back/forward restores position.
+
 ## [Unreleased]
 
 ### Added

diff --git a/packages/web/package.json b/packages/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@opentf/web",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "The native-first OTF Web runtime — signal-based reactivity and zero-VDOM DOM operations, paired with the IR-based compiler.",
   "type": "module",
   "exports": {

diff --git a/website/package.json b/website/package.json
@@ -8,10 +8,10 @@
     "build:ssg": "otfw build --ssg"
   },
   "dependencies": {
-    "@opentf/web": "^0.5.0",
-    "@opentf/web-docs": "^0.1.0"
+    "@opentf/web": "^0.6.0",
+    "@opentf/web-docs": "^0.2.0"
   },
   "devDependencies": {
-    "@opentf/web-cli": "^1.0.0"
+    "@opentf/web-cli": "^1.1.0"
   }
 }