Git Hooks

April 15, 2026 ยท View on GitHub

post-commit

Runs after every commit on the main branch only and automatically:

  • Parses the commit message (conventional commits)
  • Strips leading emoji so ๐Ÿ—‚๏ธ feat: โ€ฆ is recognised as feat:
  • Bumps version in package.json based on commit type:
    • fix: โ†’ patch (0.14.3 โ†’ 0.14.4)
    • feat: โ†’ minor (0.14.3 โ†’ 0.15.0)
    • feat!: or BREAKING CHANGE โ†’ major (0.14.3 โ†’ 1.0.0)
  • Updates CHANGELOG.md with new entry
  • Updates shell/about.html version string
  • Creates follow-up commit: chore: bump to vX.Y.Z

Commits on feature branches are not affected.

Installation (optional)

The hook is only needed if you merge directly to main. Feature-branch contributors can skip this step.

Run from repo root:

./setup-dev.sh

Or manually:

git config core.hooksPath git-hooks
chmod +x git-hooks/post-commit

Skip Hook

To commit without triggering the hook:

git commit --no-verify -m "..."