How it works
When a release is cut, the release tooling reads all commits since the previous tag, groups them by type, and appends a new section toCHANGELOG.md. The section headings map directly to Conventional Commit types:
| Changelog section | Commit type |
|---|---|
| Features β‘οΈ | feat |
| Bug Fixes π | fix |
| Refactor π οΈ | refactor |
| Performance π | perf |
| Documentation π | docs |
| Chore βοΈ | chore |
| Revert π | revert |
style, test, ci, build, and wip are typically not surfaced in the changelog.
Because the changelog is generated automatically, do not edit
CHANGELOG.md by hand. Your changes will be overwritten on the next release.Recent releases
Here is an excerpt from the most recent entries to illustrate the format:1.12.3 (2026-02-10)
Documentation π- Storybook: enable back HTML story code preview
- Enhance
esm-loader.jsto dynamically load ESM modules based on version from CDN URL - deps: update
@stencil/coreto v4.42.0 - deps: update Storybook to v10.2.7
- tsconfig change to new
jsxImportSourcealternative and remove thehimport
1.12.0 (2026-01-28)
Features β‘οΈ- Button: add support for icon-only button variant with aspect-ratio 1:1 (square)
- Steps, Step Item: add
orientationproperty and support for vertical layout
- Datepicker: prevent Cally library loading race condition with singleton promise pattern
- Select: prevent tag removal on backspace in multiselect when the input is not empty
- Datepicker: improve performance and scalability with utilities, and update the Cally library
Viewing the full changelog
The complete changelog is available in the repository: You can also view changes for a specific release range using GitHubβs compare view, linked at the top of each entry, for example:Breaking changes in the changelog
Breaking changes are called out explicitly in the commit body using theBREAKING CHANGE: footer. When reading the changelog, look for entries with ! in the type, such as refactor(checkbox)!: β these signal a breaking change with migration instructions in the PR body.
Versioning
BEEQ follows Semantic Versioning:- Patch (
1.12.2 β 1.12.3): bug fixes and minor maintenance. - Minor (
1.11.x β 1.12.0): new backward-compatible features. - Major (
1.x β 2.0.0): breaking changes.