- About
- Commit Message Format
- Suggested Emojis
- Tools
- Related Ideas
- Fun Emoji Usages
- Contributing
- License
This is an attempt to standardize the format of commit messages, for the sake of uniformity in git log, best practices for writing commit messages & fun!
Using emojis at the beginning of commit messages, other than being fun, provides a simple way to indicate the intention of that commit, an ease for the eyes when browsing/reviewing git log. It's also a simple measure of the fact that how much that commit is focused on a single purpose, which is a good practice.
If these rules and/or using emojis is an overkill for your productivity or simply losing its purposes, please tailor them to your needs or don't use them.
- Fun!
- Simple navigation through git history (e.g. ignoring style changes).
- Automatic generating of the changelog.
<type>(<scope>): <subject>
<body>
<footer>
- Capitalize the
<subject>. - Do not end the first line with a period.
- Total characters of the first line MUST be Less than or Equal to 50 characters Long.
- Use the present tense ("Add feature" not "Added feature").
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...").
- Use
<type>to identify what type of changes introduced in this commit; Allowed<type>keywords:- An Emoji(see below for list of Suggested Emojis)
- Or a Text:
- feat: new feature for the user(or โจ emoji)
- fix: bug fix for the user(or ๐ emoji)
- docs: changes to the documentation(or ๐ emoji)
- style: formatting, missing semi colons, etc; no production code change(or ๐จ emoji)
- refactor: refactoring production code, eg. renaming a variable(or ๐ emoji)
- test: adding missing tests, refactoring tests; no production code change(or ๐ฌ emoji)
- chore: updating grunt tasks etc; no production code change
- If you need more than one keyword or emoji to use, you should probably think twice!. This usally means you need to break this commit into more smaller commits; If thats not the case then separate each emoji with a space.
- Use
<scope>to identify which component this<type>is related to; Example<scope>values:- init
- runner
- watcher
- config
- web-server
- proxy
- etc.
- The
<scope>can also be empty (e.g. if the change is a global or difficult to assign to a single component), in which case the parentheses are omitted.
- Includes motivation for the change and contrasts with previous behavior.
- Use the body to explain whats and whys vs. hows.
- Wrap each line of the body at 72 characters.
- Reference issues this commit is related to with the status of that Issue; Ex.
Issue #27,Ref T27orRef T27, T56orFixes T8. - Supported issue tracker status keywords:
- Fixes
- Fixed
- Closes
- Closed
- Resolves
- Resolved
- Ref
- Issue
- Issues
- More info on issue tracker status keywords:
- It's also recommended to use Full URL to the Issues, instead of just issue ID Number; Doing so will ease browsing issues from terminal.
- In the case of multiple issues separate them with commas, Ex.
Closes #27, #56.
- Use valid MarkDown format in the
<body>. - All WIP(Work In Progress) commits SHOULD have the ๐ง Emoji.
- All WIP commits SHOULD be avoided!.
- Referencing Issues by using special keywords like
FixesorResolveswill mark them as closed automatically! For more information about automatic issue closing using ketwords see their documentation(linked above). - There is NO new-line after the
<footer>. - Every emoji text(
:emoji:) is counted as one character!. - See ToDo Grammar StyleGuide for more Information on
@XXXComment Tags.
| Emoji | Raw Emoji Code | Description |
|---|---|---|
| ๐จ | :art: |
when improving the format/structure of the code |
| ๐ฐ | :newspaper: |
when creating a new file |
| ๐ | :pencil: |
when performing minor changes/fixing the code or language |
| ๐ | :racehorse: |
when improving performance |
| ๐ | :books: |
when writing docs |
| ๐ | :bug: |
when reporting a bug, with @FIXMEComment Tag |
| ๐ | :ambulance: |
when fixing a bug |
| ๐ง | :penguin: |
when fixing something on Linux |
| ๐ | :apple: |
when fixing something on Mac OS |
| ๐ | :checkered_flag: |
when fixing something on Windows |
| ๐ฅ | :fire: |
when removing code or files, maybe with @CHANGED Comment Tag |
| ๐ | :tractor: |
when change file structure. Usually together with ๐จ |
| ๐จ | :hammer: |
when refactoring code |
| โ | :umbrella: |
when adding tests |
| ๐ฌ | :microscope: |
when adding code coverage |
| ๐ | :green_heart: |
when fixing the CI build |
| ๐ | :lock: |
when dealing with security |
| โฌ๏ธ | :arrow_up: |
when upgrading dependencies |
| โฌ๏ธ | :arrow_down: |
when downgrading dependencies |
| โฉ | :fast_forward: |
when forward-porting features from an older version/branch |
| โช | :rewind: |
when backporting features from a newer version/branch |
| ๐ | :shirt: |
when removing linter/strict/deprecation warnings |
| ๐ | :lipstick: |
when improving UI/Cosmetic |
| โฟ | :wheelchair: |
when improving accessibility |
| ๐ | :globe_with_meridians: |
when dealing with globalization/internationalization/i18n/g11n |
| ๐ง | :construction: |
WIP(Work In Progress) Commits, maybe with @REVIEW Comment Tag |
| ๐ | :gem: |
New Release |
| ๐ฅ | :egg: |
New Release with Python egg |
| ๐ก | :ferris_wheel: |
New Release with Python wheel package |
| ๐ | :bookmark: |
Version Tags |
| ๐ | :tada: |
Initial Commit |
| ๐ | :speaker: |
when Adding Logging |
| ๐ | :mute: |
when Reducing Logging |
| โจ | :sparkles: |
when introducing New Features |
| โก | :zap: |
when introducing Backward-InCompatible Features, maybe with @CHANGED Comment Tag |
| ๐ก | :bulb: |
New Idea, with @IDEA Comment Tag |
| โ๏ธ | :snowflake: |
changing Configuration, Usually together with ๐ง or ๐ or ๐ |
| ๐ | :ribbon: |
Customer requested application Customization, with @HACK Comment Tag |
| ๐ | :rocket: |
Anything related to Deployments/DevOps |
| ๐ | :elephant: |
PostgreSQL Database specific (Migrations, Scripts, Extensions, ...) |
| ๐ฌ | :dolphin: |
MySQL Database specific (Migrations, Scripts, Extensions, ...) |
| ๐ | :leaves: |
MongoDB Database specific (Migrations, Scripts, Extensions, ...) |
| ๐ฆ | :bank: |
Generic Database specific (Migrations, Scripts, Extensions, ...) |
| ๐ณ | :whale: |
Docker Configuration |
| ๐ค | :handshake: |
when Merge files |
| ๐ | :cherries: |
when Commit Arise from one or more Cherry-Pick Commit(s) |
- Commit(CLI): This is a nifty CLI tool to aid in standardizing commit messages based on this document, thanks to @jakeasmith.
- gitMoji(Firefox & Chrome Extension): Enhance your commits with emojis!, thanks to @louisgrasset.
- gitmoji: An emoji guide for your commit messages.
- Conventional Commits: A specification for adding human and machine readable meaning to commit messages.
- Keep a Changelog: Donโt let your friends dump git logs into changelogs.
- CodeEmoji: Mozillaโs Codemoji enciphers your messages with emoji for fun and profit.
- Emoji Based Diagram: Emoji Based Diagram of Data Bearing Subscription Updates(WebPush VAPID).
- HTTP status codes as emoji.
- OSI Model with emojis.
To add a new Emoji to the list: Create an Issue & Send a PR.
The Code is licensed under the MIT License.