Skip to content

Versioning policy

Claudius follows Semantic Versioning:

  • Patch / minor (1.2.x1.3.0) — backward compatible. The CDN @1 channel picks these up automatically; self-hosted embeds can update whenever convenient.
  • Major (1.x2.0) — may contain breaking changes, always with a migration guide. The @1 CDN channel never serves a 2.x build; you opt in by switching to @2.

Releases are automated with release-please from conventional commits; every release has a GitHub Release and a CHANGELOG.md entry.

These docs track the latest release. When a new major ships, the previous major’s docs are archived and stay browsable via the version switcher, so you can keep referencing the docs that match what you run.

  • CDN/self-hosted embeds: window.ClaudiusWidgetVersion in the console
  • Repo checkouts: the root package.json version, or git tag