List of emoji for git commits. π₯
Interesting idea from the Atom.io contributing docs.
Consider starting the commit message with an applicable emoji
This idea was orinially based on Atom.io contrib docs... Though, apparently not in current guide. Other examples are kinda interesting with code available online. Also worth checking out:
- https://github.com/tjoskar/gitmoji-commit-hook
- https://github.com/openhwgroup/cva6/blob/master/CONTRIBUTING.md
- https://gist.github.com/MadcapJake/04a32b4e903a1ae0774e
Be a good collaborator. Communicate the context about a change.
β‘οΈ Read More and more
- The first word should be an UPPERCASE action label and/or emoji
- Then, Capitalize the subject line
- Use the imperative mood in the subject line. Fix, Add, Change instead of Fixes, Added, Changing.
- Limit the subject line to 50 characters
- Do not end the subject line with a period
- Separate subject from body with a blank line
- Use the body to explain what and why vs. how
- Wrap the body at 72 characters
- Why is this change necessary? It may fix a bug, it may add a feature, it may improve performance, reliabilty, stability, or just be a change for the sake of correctness.
- How does it address the issue? For short obvious patches this part can be omitted, but it should be a high level description of what the approach was.
- What side effects does this change have? (In addition to the obvious ones, this may include benchmarks, side effects, etc.)
Pro-tip: Format subject line:
<emoji or ACTION:> <50 character synopsis of change>
Emoji | Markdown | Commit action label |
---|---|---|
BASIC | ||
β¨ | :sparkles: |
ADD / feature |
π | :see_no_evil: |
ADD / UPDATE gitignore |
π© | :poop: |
ADD / poor/quick code |
π | :bug: |
BUGFIX |
π§ | :wrench: |
CHANGE / re-TOOL |
π | :ambulance: |
CRITICAL HOTFIX |
π | :rocket: |
DEPLOY (build) |
π± π£ | :seedling: :hatching_chick: |
INIT |
π | :twisted_rightwards_arrows: |
MERGE |
β | :x: |
REMOVE |
DETAILED | ||
β | :heavy_plus_sign: |
ADD (new api) |
π¨ | :art: |
ADD/CHANGE (UI code) |
π | :lipstick: |
ADD/CHANGE (cosmetic / lint) |
β»οΈ ποΈ | :recycle: :building_construction: |
CHANGE (refactor) |
π | :racehorse: |
CHANGE (streamline) |
β‘ | :zap: |
CHANGE (improve performance) |
π | :memo: |
DOC |
π | :truck: |
MOVE / RENAME |
π | :name_badge: |
METADATA |
Β©οΈ | :copyright: |
LICENSE |
π | :tada: |
INIT ( begin project ) |
π | :globe_with_meridians: |
INTERNATIONALIZATION |
π | :skull: |
REMOVE (depreciate api) |
βͺ | :rewind: |
REVERT |
β | :white_check_mark: |
TEST |
:shipit: |
VERSION | |
π§ | :construction: |
WIP |
Shell Command | Result |
---|---|
git commit -m ":bug: BUGFIX: Foo bar baz ipsum blah in lorem" |
π BUGFIX: Foo bar baz ipsum blah in lorem |
git commit -m ":sparkles: Add new baz ipsum blah" |
β¨ Add new baz ipsum blah |
- https://who-t.blogspot.co.at/2009/12/on-commit-messages.html
- https://chris.beams.io/posts/git-commit/#tips
- http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
- https://github.com/erlang/otp/wiki/writing-good-commit-messages
- https://gist.github.com/rxaviers/7360908
- https://github.com/dannyfritz/commit-message-emoji