inspired from chrissiemhrk
What is a commit?
A commit message is a short description of the changes you've made to a file added before committing the changes.
What is a good commit?
Good commit messages are important not only for others who you may be collaborating on the project but also for you, to keep track of all your commits and knowing exactly what changes where maybe during that particular commit.
Subject | feat: Create new navigation bar |
---|---|
Description | explain what changes you made and why you made them |
Note: Not all commits are complex enough that they need a Description, especially if you are working on a personal project alone, and as such writing a body is optional.
You may use Text or emojis, An easy way to put the emoji is using shortcuts:
- For WINDOWS user Press
WIN + ;
- For MAC user Press
Command + Control + Space
Text | Use them |
---|---|
feat | a new feature |
fix | a bug fix |
docs | changes in documentation |
style | everything related to styling |
refactor | code changes that neither fixes a bug or adds a feature |
test | everything related to testing |
chore | updating build tasks, package manager configs, etc |
Code | Emoji | Use them |
---|---|---|
:heavy_plus_sign: |
➕ | when adding a file or implementing a feature |
:hammer: |
🔨 | when fixing a bug or issue |
:green_heart |
💚 | when improving code or comments |
:zap: |
⚡ | when improving performance |
:scroll: |
📜 | when updating docs or readme |
:key: |
🔑 | when dealing with security |
:repeat: |
🔁 | when updating dependencies or data |
:white_check_mark: |
✅ | when a new release was built |
:shirt: |
👕 | when refactoring or removing linter warnings |
:x: |
❌ | when removing code or files |
Code | Emoji | Use them |
---|---|---|
:tada: |
🎉 | when doing initial commit |
:rocket: |
🚀 | when implementing a new feature |
:hammer: |
🔨 | when fixing a bug or issue |
:art: |
🎨 | when refactor/improving code |
:scroll: |
📜 | when updating docs or readme |
:pencil: |
📝 | when doing some small updates |
You may use other emoji or text to mark your commits but try to make them as clear as you can for other to view and understand.