How to use Commits
- 1. Pick a type. feat, fix, docs, and the usual set.
- 2. Optional scope and subject. Imperative mood.
- 3. Mark breaking if needed. Adds ! and a BREAKING CHANGE footer.
- 4. Copy the message. Paste into git commit.
About this tool
Conventional Commits make changelogs and semver bumps mechanical. This helper writes type(scope): subject plus an optional body and BREAKING CHANGE footer so you do not have to remember the punctuation.
Types
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
Semver
feat → minor, fix → patch, breaking → major, if you follow the spec.
Open-source repo checklist
Conventional commits pair with semver bumps and changelogs. For a public release, also add a .gitignore, pick an SPDX license identifier, and commit a LICENSE file — use the SPDX License tool for MIT, Apache-2.0, and other common ids.
Code examples
Commit
feat(api): add health endpoint