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.

---

v0.3.0 - 2026-08-02

Breaking

• The ai-credits plugin is removed. AI credit management is now owned by the plans plugin. Drop aiCreditsPlugin from your plugin list and make sure plansPlugin is registered instead, on both the server and the client.
• The AI credit purchase flow moved from a sidebar panel to a dedicated page. Any deep link you kept to the old panel needs updating.

Changed

• Realtime editing now reads renamed environment variables for its Supabase client. Check Environment and License before deploying.

Fixed

• An AI request now fails with a clear error when a configured provider cannot be loaded, instead of silently retrying against nothing.
• Optional AI provider packages resolve correctly under Turbopack.
• Bound page metadata no longer renders escaped HTML entities in titles and descriptions.
• Heading anchor ids survive raw binding sanitization, so in page anchors keep working on pages that use {{ }} bindings inside headings.
• 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.