Upgrade Guide

Kyro CMS follows semantic versioning. Future breaking changes and migration steps will be documented here.

v0.12.66

Astro 7+ Required: The astro peer dependency is now ^7.1.1. Astro 5 and 6 are no longer supported. Upgrade your project with pnpm add astro@latest.

v0.12.61

defineKyroConfig Standardization (Breaking): The config export is now exclusively defineKyroConfig. If you were importing defineConfig from @kyro-cms/core, rename it to defineKyroConfig to avoid collision with Astro/Vite's own defineConfig.
kyro-app.ts Rebranding: Internal server init renamed from hono-app.ts / HonoAppOptions to kyro-app.ts / KyroAppOptions. Update any direct imports of HonoAppOptions.

v0.12.44

ESM Code-Splitting Enabled: @kyro-cms/core now emits split ESM chunks (splitting: true). If you previously relied on the monolithic bundle shape, dynamic imports may now resolve differently. Verify any custom Vite/Rollup configurations that reference dist/ internals.

v0.12.21

Admin Sidebar Minimization: The admin sidebar now collapses to a 76px icon rail. No config changes required; purely additive.
Role-Based Navigation: Sidebar links are automatically filtered by user role (super_admin, admin, editor, author, customer). Review role assignments to ensure users see the correct navigation items.

v0.12.20

User Registration Toggle: A new Enable User Registration setting controls access to POST /api/auth/register and the /admin/register page. Registration is disabled by default on new installs — enable it explicitly in System Settings if needed.
RBAC Role Protection: Role changes are now restricted to super_admin only. Existing admin-level code that modifies user roles via the API will receive 403 Forbidden responses.

v0.12.18

Dynamic Content Overrides: Full support for "<blocksFieldName>.<blockSlug>.<fieldInBlock>" syntax in collectionOverrides.
Form State & React Deduplication: Updated @kyro-cms/astro integration to deduplicate react and react-dom in Vite config.
Array Item Titles: Excluded discriminator keys (linkType, type, blockType, etc.) from being selected as tab titles.

v0.12.17

Dynamic Content Overrides: Supports path syntax "<blocksFieldName>.<blockSlug>.<fieldInBlock>" in collectionOverrides.
Array Item Tab Titles: Discriminators (linkType, type, blockType, etc.) are automatically ignored in favor of real title/label/relationship targets.
Legacy Tabs Migration: If migrating from legacy nested tab structures, use node scripts/flatten-tabs.mjs --execute.

v0.12.16

Release of Kyro CMS v0.12.16.