Question 1

What is a conventional commit?

Accepted Answer

A conventional commit is a standardized commit message format that makes commit histories readable and enables automated tooling. The format is: type(scope)!: subject. Common types include feat (new feature), fix (bug fix), docs (documentation), style (formatting), refactor (code change without feature or fix), perf (performance), test (testing), and chore (maintenance).

Question 2

What is the purpose of the scope field?

Accepted Answer

The scope is an optional noun describing the section of the codebase affected by the commit. For example, feat(auth): add OAuth login, fix(api): handle null response, or refactor(ui): simplify button component. Scopes help developers quickly understand which part of the system was changed.

Question 3

What does the breaking change (!) flag mean?

Accepted Answer

A breaking change means the commit introduces an API incompatibility — something that will require callers or dependents to change their code. In semantic versioning, a breaking change triggers a major version bump (e.g. 1.2.3 to 2.0.0). Add BREAKING CHANGE: description in the footer to explain what changed and how to migrate.

Question 4

How does this generator help with semantic versioning?

Accepted Answer

Conventional commits map directly to semver: feat commits trigger a minor version bump (1.2.3 to 1.3.0), fix commits trigger a patch bump (1.2.3 to 1.2.4), and any commit with BREAKING CHANGE triggers a major bump. Tools like semantic-release and standard-version can automatically determine the next version number from commit history.

Question 5

Can I use this format with GitHub, GitLab, or Bitbucket?

Accepted Answer

Yes. Conventional commits are a text-based standard that works with any git host. GitHub and GitLab can render commit messages in PR/MR lists. Many CI/CD pipelines use commit message conventions to automate changelog generation, version bumping, and release tagging.

Git Commit Message Generator

Frequently Asked Questions

Comments & Feedback