Git Commit

Conventional Commits Format

<type>(<scope>): <subject>

<body>

<footer>

Types

Rules

Subject Line

• Max 50 characters
• Imperative mood ("add" not "added")
• No period at end
• Lowercase

Body (optional)

• Wrap at 72 characters
• Explain what and why, not how
• Separate from subject with blank line

Footer (optional)

• Reference issues: Closes #123, Fixes #456
• Breaking changes: BREAKING CHANGE: description

Examples

Simple

feat(auth): add OAuth2 login support

With Body

fix(api): handle null response from payment gateway

The payment gateway occasionally returns null instead of an error
object when the service is degraded. This caused unhandled exceptions.

Added null check and appropriate error handling.

Fixes #789

Breaking Change

refactor(api)!: change user endpoint response format

BREAKING CHANGE: The /api/users endpoint now returns an object
with a `data` wrapper instead of a raw array.

Before: [{ id: 1, name: "John" }]
After: { data: [{ id: 1, name: "John" }], meta: { total: 1 } }

Commands

# Stage and commit
git add .
git commit -m "feat(scope): description"

# Amend last commit
git commit --amend

# Interactive rebase to fix commits
git rebase -i HEAD~3