chaipro v0.5.0

Released 2026-11-16. Upgrading from v0.4.4. v0.4.5 was tagged the same day with the same code; upgrade straight to v0.5.0.

The headline is linked pages: a site can show a page your platform supplies and keep it in sync until the site duplicates it. Around it, global blocks can be turned off for a platform, and the theme gains a site layout setting.

Breaking

  • Upstream pages come from your platform. Register a LIST_UPSTREAM_PAGES action and pass upstreamPageSource with findLinkable and getContent. ChaiBuilder stores only the upstream page's id. getContent receives the site it is for. See Linked Pages.
  • Section gutter tokens are replaced by Content-Gutter-X (dt#content-gutter-x) and Content-Gutter-Y (dt#content-gutter-y). Blocks that used the old tokens need the new ids. See Design Tokens.
  • The skills package is renamed from @chaibuilder/skills to chaiskills, and its command from chaibuilder-skills to chaiskills. See Agent Skills.

Added

  • Linked pages. Add New Page offers "Create from scratch" or "Link upstream page", with options grouped under your headings. A linked page opens view-only and shows the upstream content; Duplicate and edit makes an editable copy and Reset links it again, both after a confirmation. The pages manager labels pages Linked or Cloned. Name the feature for your users with labels.features.upstreamPage. Linked page caches carry upstream-page-<id> for you to revalidate.
  • View-only page mode in the builder: the page never saves, SEO opens read-only, and the canvas still pans.
  • The partialBlocks flag (default on). Off hides "Create global block", the Create button in the pages manager, the Global Blocks tab and search results, and a placed global block's settings and styles. Existing global blocks keep rendering. See Global Blocks.
  • Global block usage list. A placed global block's settings list the pages that use it.
  • Global blocks in the library page editor.
  • Site layout. With the siteLayout flag, the Theme panel offers fluid, container or narrow, emitted as --site-content-width. The Site-Content-Width token follows it, and new Layout-* tokens cover common section widths. See Theming.
  • Areas show as Area in the outline, in the slot icon's blue, and offer no "Create global block".
  • The Add Page and Create global block buttons have stable ids.

Changed

  • Content-Gutter-X is px-4 sm:px-8.
  • Blocks are no longer capped by a site layout root rule; only blocks that use the layout tokens follow the site layout.

Fixed

  • Reset clears the duplicate's own design tokens.
  • Duplicate and reset move past the page version they read, so a later save cannot undo them.
  • A linked page gets no language pages until it is duplicated, and a dynamic linked page has no "View live".
  • The upstream page list is kept per site.
  • One request state per process, shared by every copy of the module.

Upgrade notes

  1. Upgrade the package with pnpm up chaipro@^0.5.0.
  2. Using the old section gutter tokens? Replace them with dt#content-gutter-x and dt#content-gutter-y.
  3. Using linked pages? Turn on features.upstreamPages, pass upstreamPageSource and register LIST_UPSTREAM_PAGES. See Linked Pages.
  4. Using the agent skills? Run pnpm dlx chaiskills add to switch to the renamed package.

© ChaiBuilder. All rights reserved.

ChaiBuilderMade withChaiBuilder