carloscuesta /gitmoji
An emoji guide for your commit messages. 😜
★ 16,813⑂ 822👁 74⑃ 1,457● 608▤ 26
More from this author
+0
Daily
16,813
stars
822
forks
74
watchers
1,457
prs
608
issues
26
releases
README
About Gitmoji is an initiative to standardize and explain the use of emojis on GitHub commit messages. Using emojis on commit messages provides an easy way of identifying the purpose or intention of a commit with only looking at the emojis used. As there are a lot of different emojis I found the need of creating a guide that can help to use emojis easier. The gitmojis are published on the following package in order to be used as a dependency 📦. Using gitmoji-cli To use gitmojis from your command line install gitmoji-cli. A gitmoji interactive client for using emojis on commit messages. bash npm i -g gitmoji-cli Example of usage In case you need some ideas to integrate gitmoji in your project, here's a practical way to use it: [scope?][:?] - intention: An emoji from the list. - scope: An optional string that adds contextual information for the scope of the change. - message: A brief explanation of the change. Contributing to gitmoji Contributing to gitmoji is a piece of :cake:, read the contributing guidelines. You can discuss emojis using the issues section. To add a new emoji to the list create an issue and send a pull request, see how to send a pull request and add a gitmoji. Spread the word Are you using Gitmoji on your project? Set the Gitmoji badge on top of your readme using this code: html License The code is available under the MIT license.
Top issues
#725🕵️ for changes to enhance observability25 comments · 2021-03-14#924Improve searching on the site19 comments · 2021-11-29#1898Use 🧠 for updating AI-based features18 comments · 2025-04-11#573Verbose Gitmoji Descriptions10 comments · 2020-09-19#2008🤖 AI related code / files7 comments · 2026-03-13#1726New Post / Content Gitmoji7 comments · 2024-04-25#1737🌳 for improving sustainability / green coding5 comments · 2024-05-03#1724⚙️ for repo configuration changes (e.g. issue/PR templates)5 comments · 2024-04-12
Latest release
gitmoji v3.15.0 v3.15.0 2025-03-12What's Changed ✏️ Fix typo in README by @ryuapp in https://github.com/carloscuesta/gitmoji/pull/1616 ⬆️ Bump eslint-plugin-import from 2.28.1 to 2.29.0 by @dependabot in https://github.com/carloscuesta/gitmoji/pull/1617 ⬆️ Bump jest and @types/jest by @dependabot in https://github.com/carloscuesta/gitmoji/pull/1618 ⬆️ Bump eslint-config-next from 13.4.19 to 14.0.1 by @dependabot in https://github.com/carloscuesta/gitmoji/pull/1619 ⬆️ Bump @typescript-eslint/parser from 6.5.0 to 6.9.1 by @dependabot in https://github.com/carloscuesta/gitmoji/pull/1620 ⬆️ Bump @types/react from 18.2.25 to