Changelog#

All notable changes to Cairn are automatically generated from conventional commits and published as GitHub Releases.

Release Process#

When a version tag is pushed (git push origin v0.2.0), GitHub Actions automatically:

  1. Runs tests and linting
  2. Builds binaries for all platforms (Linux, macOS, Windows — amd64 and arm64)
  3. Generates release notes from commits since the last tag
  4. Creates a GitHub Release with binaries and SHA256 checksums

Commit Message Format#

<type>(<scope>): <description>

<body>

<footer>

Types#

TypeAppears in Release NotesDescription
featYesNew feature
fixYesBug fix
perfYesPerformance improvement
docsNoDocumentation changes
refactorNoCode refactoring
testNoTests
ciNoCI/CD changes
choreNoBuild, dependencies

Examples#

# New feature
git commit -m "feat(sync): Add auto-sync on startup"

# Bug fix with scope
git commit -m "fix(tui): Resolve bookmark list rendering issue"

# Breaking change (! suffix)
git commit -m "feat!: Change bookmark ID format"

# With body
git commit -m "feat(extension): Add Vicinae bookmark integration

- Search bookmarks from launcher
- Save current page as bookmark
- Browse all bookmarks in Vicinae"

Full Changelog#

See the GitHub Releases page for the complete, auto-generated changelog.

Backward Architecture