Release policy
What you can rely on.
How often Kaleta is released, how sites update, and what never breaks without notice – for your own site and for the sites you build for clients. It applies from Kaleta 2.1.
A steady pace.
A new minor release with features every week on the Latest channel, about once a month on the Stable channel. Patch and security releases when they are needed. A major release at most once a year.
One-step updates.
The latest release is supported, and a site on an earlier version reaches it in one step from Settings → Backups and updates, with no required stops in between. Each release is tested by updating installations from 1.2 onward on MySQL and MariaDB.
Security on its own.
Security releases install themselves unless the administrator turns off automatic security updates: the site backs up its database and checks the signature and the checksum first.
No surprise removals.
Before anything goes, it is announced, shown in System status on the sites that use it, kept for at least two minor releases and six months, and removed only in a major release.
A recorded contract.
The tools of the Claude connection, the design tokens, the builder elements and the extension API for add-ons are recorded in the repository. The tests fail if any of them is removed or changed.
A public record.
Every release is announced on GitHub and in the changelog here, in English, Czech and German.
ChangelogRelease channels
Latest or Stable.
Since Kaleta 3.8 every site follows one of two update channels. You choose it in Settings → Backups and updates.
- Latest – the default for every site. A new minor version every week, and security releases.
- Stable – security fixes only, and a move to a newer minor about once a month, after that minor has run on Latest. A site on Stable is never offered a version older than the one it runs.
Both channels are signed with the same publisher key and checked the same way.
Compatibility
The public contract.
Covered by the rules above:
- The Claude connection (MCP) – tool names, parameters and their types, required parameters and each tool's annotations. The older Czech tool names keep working too.
- Design tokens – the stored names such as
--ka-barva-primarniand the English ones such as--ka-color-primary. - Builder elements and their content, so every saved page keeps rendering.
- The site export – it can be imported into the same or any later release.
- Addresses of your content – an update never changes them; when you change the address of a page, news item or category, Kaleta adds a redirect.
- The update channel and its signatures.
Not covered: PHP classes, functions and database tables, the HTML of the admin and the exact markup of public pages, and the wording of texts. Add-ons build on the versioned extension API instead (since Kaleta 3.0, described in docs/EXTENSIONS.md), which is recorded as a contract of its own.
The full policy
The policy lives in the repository next to the code, and every change to it is public.