Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Conventional Commits

jj-release follows the Conventional Commits spec to determine the version bump. It natively supports standard Angular types alongside a dedicated bug type:

Commit typeBumpChangelog Header
feat:minorAdded
fix:patchFixed
bug:patchBug
refactor:patchChanged
perf:patchPerformance
docs:No releaseDocumentation
feat!: or BREAKING CHANGE footermajorBreaking
chore:, docs:, test:, etc.No releaseDropped by default
deprecate:, deprecated:No releaseDeprecated
chore:, test:, ci:No releaseDropped by default

The highest bump across all commits since the last tag wins. Scoped commits are preserved in the changelog. feat(cli): add init subcommand renders as **(cli)** add init subcommand under ### Added

Note

chore:, docs:, style:, test:, ci:, and build: commits do not trigger a release. If your only changes since the last tag are in these categories, jj-release will exit with “No releasable commits”. Either add a feat: or fix: commit, or force a bump in release.toml:

[bump]
force = "patch"

Remove force after the release so future versions are computed automatically.