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_PAGESaction and passupstreamPageSourcewithfindLinkableandgetContent. ChaiBuilder stores only the upstream page's id.getContentreceives the site it is for. See Linked Pages. - Section gutter tokens are replaced by
Content-Gutter-X(dt#content-gutter-x) andContent-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/skillstochaiskills, and its command fromchaibuilder-skillstochaiskills. 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 carryupstream-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
partialBlocksflag (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
siteLayoutflag, the Theme panel offers fluid, container or narrow, emitted as--site-content-width. TheSite-Content-Widthtoken follows it, and newLayout-*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-Xispx-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
- Upgrade the package with
pnpm up chaipro@^0.5.0. - Using the old section gutter tokens? Replace them with
dt#content-gutter-xanddt#content-gutter-y. - Using linked pages? Turn on
features.upstreamPages, passupstreamPageSourceand registerLIST_UPSTREAM_PAGES. See Linked Pages. - Using the agent skills? Run
pnpm dlx chaiskills addto switch to the renamed package.
Related
- chaipro v0.5.1 - the next release.
- chaipro v0.4.4 - the previous release.
- chaipro Changelog - all releases.

