carloscuesta/gitmoji

Gitmoji is a standardized guide for using emojis in Git commit messages. A commit message is the short description you write each time you save a new version of your code, for example, "Fixed login bug" or "Added new payment page." Gitmoji proposes adding an emoji at the start of each message to quickly signal what type of change was made, so anyone glancing at the commit history can instantly understand the purpose of each change without reading the full description. The project provides a curated list of emojis, each with a defined meaning, for instance, one emoji might mean "bug fix," another might mean "new feature," and another might mean "documentation update." The format suggested is: an emoji representing the intent, an optional scope (the part of the codebase affected), and a short message. A companion command-line tool called gitmoji-cli can be installed as a package to make writing these commit messages interactive from the terminal, walking you through selecting the right emoji. The emoji definitions are also published as a standalone package so other tools can build on top of them. Someone would use Gitmoji to make their project's version history easier to scan at a glance, especially on teams where multiple people are making changes. It's particularly useful for open-source projects displayed on GitHub, where the emoji add visual context to the commit timeline. The project is written in TypeScript and licensed under MIT.