Commit Type | Title | Description | Emoji | Release | Include in changelog |
---|---|---|---|---|---|
feat |
Features | A new feature | β¨ | minor |
true |
fix |
Bug Fixes | A bug Fix | π | patch |
true |
docs |
Documentation | Documentation only changes | π | patch if scope is readme |
true |
style |
Styles | Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc) | π | - | true |
refactor |
Code Refactoring | A code change that neither fixes a bug nor adds a feature | π¦ | - | true |
perf |
Performance Improvements | A code change that improves performance | π | patch |
true |
test |
Tests | Adding missing tests or correcting existing tests | π¨ | - | true |
build |
Builds | Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm) | π | patch |
true |
ci |
Continuous Integrations | Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) | βοΈ | - | true |
chore |
Chores | Other changes that don't modify src or test files | β»οΈ | - | true |
revert |
Reverts | Reverts a previous commit | π | - | true |
Convention to format the message is: feat(scope): β¨ Message
and so on.
Aliases allow to have additional commit types (in a tool like commitizen) that can be formatted to follow regular conv commit style.
For example the commit CLI could present the choice initial
and the final commit message will be 'feat: π Initial commit'
Commit Type | Maps to | Title | Description | Emoji |
---|---|---|---|---|
initial |
feat |
Initial | Initial commit | π |
dependencies |
fix |
Dependencies | Update dependencies | β¬οΈ |
peerDependencies |
fix |
Peer dependencies | Update peer dependencies | β¬οΈ |
devDependencies |
chore |
Dev dependencies | Update development dependencies | β¬οΈ |
metadata |
fix |
Metadata | Update metadata (package.json) | π¦ |