Release notes

0.2.15 — 2026-09-08 (library)

Fix early client navigation by allowing React hydration to be superseded and avoiding hydration of stale server markup.
Add metadata-only MDX imports for navigation and avoid loading raw page bodies for production search.
Fetch search previews only while the palette is open, and cancel stale requests.
Make both navigation rails configurable with wider 280px defaults, and stabilize sidebar labels while scrolling.
Support independent product version manifests.

Per-tab version chips: new TabDef.versionChips field scopes the topbar version chips to a top-level tab. A tab omitting the field inherits the global versionChips; [] shows none on that tab; a non-empty array replaces them for that tab only. Lets a site show cli-only chips on the CLI tab, py-only on the Python tab, and none on design/other tabs.

Dependency layout: react/react-dom peers widened to >=19 (org convention: sites track react@latest); tailwindcss moved from a dependency to a ^4 peer so it resolves at the consuming site's root under strict CI installs.

Chip component: the canonical badge idiom is now a first-class export — <Chip> with muted / accent / warn variants, clickable (onClick renders a real button), and className/style passthrough for one-off colors. Registered in the MDX component map, so <Chip> works in any page without an import.
The topbar DEV badge, the gallery status chips, and the TestStatus badge now render through <Chip> — no visual change, the idiom is just defined once.

Search-engine opt-in: new indexable field — sites are noindex, nofollow by default per org policy; set indexable: true on the sites meant to be publicly discoverable. In-site search and the llms/skill surfaces are unaffected.

DEV badge: the dev-mode indicator in the topbar is now a labeled warn-colored DEV chip (was a small orange dot); clicking it still turns the hidden-pages toggle off.
headScripts SiteConfig field: external script URLs injected into every page head at SSR time — restores integrations like the Studio design-picker bridge for migrating sites.

All-hidden tabs hide: a tab whose pages are all hidden (e.g. an internal /dev tab) no longer renders in the topbar unless the hidden-pages toggle is on or you are already inside it.

Fleet features upstreamed from the newest DreamLake docs sites, ahead of the org-wide migration onto dockit:

Segmented ThemeToggle (from uikit/dreamlake): new themeToggle SiteConfig field — 'cycle' (default, the existing single cycling button) or 'segmented' (the three-button slider with a sliding indicator). See Theming. This site runs 'segmented'.
Preview fullscreen (from uikit): an expand button in the Preview header grows the frame to a full-viewport overlay for wide demos; Esc exits. Icons are inlined SVGs — no new dependency.
Trailing-slash-tolerant path matching (from studio): new normalizePath / findPage exports, used everywhere active-page matching happens (sidebar aria-current, breadcrumbs, <title> sync, prev/next, TOC md/edit links) so prerender and client routing agree. See Sidebar.
dev: frontmatter alias (from studio): dev: true now implies hidden: true + noindex: true, so studio content migrates unchanged. See Authoring.
VersionBadge exported standalone (donor: uikit), with the version-switcher manifest now fetched production-origin-first so frozen deploys list current releases (needs the /versions.json CORS header — in netlify.example.toml and Releases & versioning).
CodeBlock header controls (language / :set nu / copy) are now hover-gated, keeping prose-adjacent code blocks quiet (#8).

New Releases & versioning guide — the versioned docs-deploy flow as consumer-facing docs: the two version axes, the versions.json manifest, the actual set-version.mjs / version-branch.sh scripts embedded from source, Netlify branch-deploy URLs, and the prod/staging promotion flow. The hidden Versioning dev page slims down to workspace-internal details.
The library now ships a copy-in release kit at templates/ — set-version.mjs, version-branch.sh, versions.example.json, netlify.example.toml — referenced from the Quickstart and migration guide.
versions.json URL-scheme fix: per-version entries now point at the canonical Netlify branch-deploy addresses (v<x-y-z>--dockit-docs.netlify.app), which resolve without any DNS setup, instead of pretty subdomains that required a manual Netlify domain-management step per release.

Docs reorganized into the five-tab tree — Get Started, Guides, Components, Skills, Reference — with 301 redirects covering the old URLs (see Netlify). Deploy internals (Netlify, versioning) moved into the hidden Dev cluster; the dockit skill got its own page.
New migration guide for moving an existing docs site onto dockit.
Component gallery added under the hidden Dev section.
Skill-generation upgrades in gen-llms.mjs: curated "Use when" triggers via the skillTriggers config field (ships in library 0.1.1 below), quickstart + routing guidance in the generated SKILL.md, and a bundled api-types.md type reference.
"Orient your agents" CLAUDE.md fragment for consuming repos, in the Quickstart and migration guide.

noindex: true pages are now excluded from the pagefind index: the Layout omits data-pagefind-body on them, matching what the docs always said (see Search). Previously the marker was stamped on every page, so noindex pages still got indexed.
The skillTriggers SiteConfig field ships — the curated "Use when" phrases consumed by skill generation.
The package ships the templates/ release kit — set-version.mjs, version-branch.sh, versions.example.json, and netlify.example.toml, ready to copy from node_modules/@dreamlake/dockit/templates/ (see Releases & versioning).

Initial release. The docs shell extracted from lakeshore-workspace into the @dreamlake/dockit package: components, the navigation/search/tabs singletons plus initDocs, the Vike renderer entries, the dockit() Vite plugin factory, and styles.css with its @source directive.
Published as pure ESM, without sourcemaps — see Package exports.
dockit.dreamlake.ai live, built with the library itself.