Release notes for chaipro, the licensed package your project depends on. Versions are semantic; while the package is pre 1.0, breaking changes land on minor bumps, so read the Breaking group before upgrading across one.

Upgrade procedure: Releases and Upgrading.

Releases

Every release from v0.3.0 onward has a page of its own, with the full detail and its upgrade notes. Releases before v0.3.0 are summarised on this page.

Version	Date	Headline
v0.3.3	2026-08-14	Breaking. Repeater data sources, block variants, design tokens in custom blocks, and a large SEO repair
v0.3.2	2026-08-04	AI provider subpackages that survive a production build, and the aiAdvancedPlugin rename
v0.3.1	2026-08-04	Video, document and audio uploads, server side upload validation, two hydration fixes
v0.3.0	2026-08-02	Breaking. The AI credits plugin is removed and folded into the plans plugin

---

Releases before v0.3.0

v0.2.7 - 2026-07-31

Changed

• Realtime editing now reads renamed environment variables for its Supabase client. Check Environment and License before deploying.
• AI credit accounting is merged into the plans plugin, and the credit purchase flow moves from a sidebar panel to a dedicated page. The old plugin stays as a deprecated alias here and is removed in v0.3.0.

Fixed

• Changing a page slug now revalidates pages linking to both the primary page and its language variants. The link slug cache tag is no longer coupled to the page tag, so a slug change invalidates less than it used to.

v0.2.6 - 2026-07-29

The AI generation reliability release.

Added

• Multi section AI generation announces a section plan first, then reports a per section progress checklist as it works.
• Each completed section is checkpointed, so a timeout mid generation keeps the sections already built instead of discarding the page.
• AI generated pages use real stock photos instead of grey placeholder boxes.

Changed

• AI panel visual pass: a single spinner instead of several, a real accent color, and a pinned progress tracker with a scroll to bottom button.

Fixed

• Corrupt or half built page generations.
• The section checklist no longer marks sections done before they are.
• Low contrast "Done" text and oversized running state text in the AI panel.
• Tool errors and image labels now render correctly in the panel.

v0.2.5 - 2026-07-27

The partial blocks release.

Added

• Nested partial blocks, up to two levels deep. All nesting rules derive from one maximum depth value, so behavior is consistent across the outline, the canvas and rendering.
• Deleted partial blocks are flagged in the outline instead of failing silently.
• Tags are scoped to partials. The page creator form no longer asks for tags, and the default site tags are trimmed to Section and CTA.
• Page manager search and filtering improvements.

Changed

• Realtime editing is now a client plugin. Register it explicitly if you use it.

Fixed

• Pages consuming a partial are reindexed when that partial's nested partials change.
• Trashed partials are excluded from draft mode rendering.
• Missing partial detection no longer fires on unrelated errors.

v0.2.4 - 2026-07-24

Page locking, global and partial blocks, and tagging.

Added

• Collaborative page locking, with takeover requests and a force edit path, backed by realtime editing sync.
• Tags on pages, global blocks and partial blocks, with tag filters in the pages manager and in the add block panel.
• A separate Layouts tab in the builder.
• A "Create Global Block" button in the Partials tab. Global block names now show in the outline and in the errors panel, and selecting an error navigates to the block.
• One unified search box across all add block tabs, replacing the per tab search.
• A search result preview at the bottom of the SEO panel.

Changed

• Form submissions persist to a Payload collection instead of the ChaiBuilder table. See Structured Content for where they land.
• The Partials tab is list styled, with hover expanding descriptions and fixed height cards.

Fixed

• Canvas inline text editing produces a single undo step instead of one per keystroke, and an active inline edit commits before undo or redo runs.
• AI generated blocks are never nested inside a partial block, and AI emitted partial blocks resolve to registered block types.
• Partial names show in the outline for dropped and AI added blocks.
• Canvas scroll to selected block viewport math.
• Image optimization on rendered pages.

v0.2.3 - 2026-07-22

Breaking

• Migrated to Tailwind CSS v4 with CSS first config. Projects on v3 config files need to migrate. See Theming.

Added

• A per block client error boundary in the render pipeline, so one failing block no longer takes down the page.

v0.2.2 - 2026-07-22

Added

• Rich text editor gains tables and markdown paste. Pasted markdown code fences convert to code blocks, with syntax highlighting.
• Typography controls for styling rich text.
• Docs and DocVersions collections, plus a DocsSidebar block and its data provider, for building documentation sites.
• Configurable document identifier and page type overrides on the Payload side.
• The root app can override AI prompts and register additional AI tools. See AI Customization.
• A dynamic page search accepts a typed identifier when there is no match.

Changed

• aiProPlugin is renamed to aiPlugin. aiProPlugin remains as a deprecated alias and will be removed in a future release.
• The licensing plugin registers implicitly on the client. Remove any manual registration.

Fixed

• Dynamic page SEO: the canonical URL uses the requested path, and hreflang alternates carry the dynamic segment.
• Trashed pages are excluded from slug resolution.
• Paginated listing slugs resolve to their base page, and alternate language dynamic URLs no longer 404.
• Headings render with ids.
• Draft mode is forwarded correctly through WithChaiLayout into the render pipeline and into block data providers.
• Form inputs no longer lose typed values on import from HTML.

v0.2.1 - 2026-07-20

Added

• Plugins can contribute instance namespaces, reachable as cb.<namespace>.*.
• Individual client plugins are exported, so you hand pick the editor plugin list rather than taking a preset.

Changed

• Plugin presence means enabled. There is no separate on flag.
• Each plugin owns its migrations, and migrations are host owned. See Database Setup.
• Per dialect schemas and per plugin package subpaths.

Fixed

• CHAIBUILDER_POSTGRESS_SCHEMA values are trimmed, so a stray space no longer breaks schema resolution.

v0.2.0 - 2026-07-20

The plugin architecture release. This is the largest breaking change in the 0.x line.

Breaking

• Features are now plugins, registered explicitly rather than switched on with config flags. Redirects, trash, media search, revisions, animation, multilingual, layout (_layout pages), page errors, licensing, roles and AI all become plugin registrations. Replace your feature flags with the matching plugin. See Configuration.
• The extraPermissions config option is dropped. Plugins register their own permission keys and their default role grants.
• Database backed role management is now the roles plugin, and it is opt in. Register rolesPlugin if you rely on it.

Added

• AI providers are pluggable rather than OpenRouter specific, with built in OpenAI compatible and Cloudflare Workers AI providers.
• OpenRouter is supported via OPENROUTER_API_KEY.
• Pages auto save once an AI action completes, including translation.

Fixed

• The revisions panel showed UTC instead of local time.
• The media manager falls back to the site tab when the active plugin tab disappears.
• Publish revalidation works again: the Next.js framework adapter registers from createPayloadChaiBuilder.

v0.1.14 - 2026-07-17

Fixed

• Re-entrant getChaiBuilder calls no longer deadlock the context resolver.

v0.1.13 - 2026-07-17

Changed

• Builder load performance: the code editor is no longer bundled, and block settings, styling, the rich text editor and the block catalogue load on demand.

Fixed

• A leaked copy to clipboard timer, and untranslated loading fallbacks.

v0.1.12 - 2026-07-17

Changed

• The save page permission check uses the CHAI_PERMISSIONS constant instead of a hardcoded string.

Fixed

• Link field focus lands on the correct input when the link type changes.

v0.1.11 - 2026-07-17

Added

• createChaiBuilder returns a bound handle, getChaiBuilder, that carries the request context and resolves permissions from it. See API.
• The request context is resolved from Payload, so authorization is answered once per request.

Fixed

• Postgres is no longer pulled into SQLite bundles.

v0.1.10 - 2026-07-17

Fixed

• The server-only package is replaced with a runtime browser guard, which unblocks test runners and bundlers that choked on it.

v0.1.9 - 2026-07-16

Maintenance release.

v0.1.8 - 2026-07-16

Added

• Drizzle schema and relations are exposed via package subpaths, for projects writing their own schema hook.
• chaiBuilderSchemaHookSqlite is re-exported from the Payload barrel.

Fixed

• Binding editor field overflow and truncation, and image fallback logic.

v0.1.7 - 2026-07-16

Maintenance release.

v0.1.6 - 2026-07-16

Changed

• Admin components import from chaipro/payload/client. Update your import map.

v0.1.5 - 2026-07-16

Breaking

• Digital asset manager configuration is unified under a top level mediaManager option. See Storage Configuration.

Added

• chaipro/tailwind entry points, with v3 and v4 auto detection in the render path.
• Logging out of the parent editor logs out the embedded CMS.

v0.1.4 - 2026-07-16

Added

• A CMS switcher to toggle between the visual editor and the CMS view.
• An id on the license overlay element, for targeting in custom styles.

v0.1.3 - 2026-07-16

Added

• Tailwind CSS v3 and v4 are both supported. The version is resolved from CHAI_TAILWIND_VERSION and defaults to v4.

Changed

• Page style compilation is materially faster, via a compiler pool and caching.

Fixed

• Page CSS is deduplicated against the build generated global stylesheet.
• Tailwind stylesheets are vendored so they resolve inside serverless bundles, including under the pnpm symlink layout.

v0.1.2 - 2026-07-15

Redirects, data binding and JSON-LD.

Breaking

• AI models and media manager providers resolve from the server config, not the client.
• Editor UI flags, revisions flags and server flags all move under features. Revisions flags group into features.revisions.
• Redirects default to off.

Added

• A redirects module: a redirects panel, a 404 handling hook, and redirects:* permissions gating the panel.
• Data binding badges and a {{ suggestion dropdown across settings fields, link href, SVG and icon fields, and the SEO panel. See Data Binding.
• A JSON-LD tab in the SEO panel, wired to the data binding field picker.
• _layout pages and WithChaiLayout, with named page slots for custom routes.

Changed

• Builder sidebar panels are ordered explicitly rather than by registration order.

Fixed

• The block level floating AI is confined to the selected block, and streams through the page chat path.
• Stale revisions are deleted in chunks instead of one large transaction.
• Protocol relative redirect targets are rejected.
• AI icon edits resolve Lucide icon name aliases, so the correct icon is picked.

v0.1.1 - 2026-07-14

Maintenance release.

v0.1.0 - 2026-07-13

First tagged release of the current chaipro line.

---

Releases before v0.1.0 were private betas and are not documented here.