# carloscuesta/gitmoji

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/carloscuesta-gitmoji).**

16,768 stars · 828 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/carloscuesta/gitmoji
- Homepage: https://gitmoji.dev
- awesome-repositories: https://awesome-repositories.com/repository/carloscuesta-gitmoji.md

## Topics

`commits` `emoji` `gitmoji`

## Description

Gitmoji is a suite of tools and guidelines designed to implement visual indicators and standardized emoji conventions within Git version control. It provides a Git commit emoji guide and a convention tool to categorize code changes, improving the readability and searchability of project logs.

The project includes a command-line interface emoji picker that allows users to browse and select emojis to speed up the process of writing commit messages. This interactive selector helps standardize the meaning of messages across a project's version control history.

The system covers version control documentation and workflow optimization through an interactive command-line interface and a curated mapping of emojis to specific commit categories.

## Tags

### User Interface & Experience

- [Emoji Pickers](https://awesome-repositories.com/f/user-interface-experience/emoji-pickers.md) — Provides an interactive command-line emoji picker for selecting visual indicators for commit messages. ([source](https://cdn.jsdelivr.net/gh/carloscuesta/gitmoji@master/README.md))
- [Emoji Mapping Libraries](https://awesome-repositories.com/f/user-interface-experience/emoji-mapping-libraries.md) — Uses a structured JSON dictionary to map specific emoji characters to their corresponding commit category labels.

### Development Tools & Productivity

- [Git Tooling](https://awesome-repositories.com/f/development-tools-productivity/git-tooling.md) — Offers a set of tools and standards to categorize code changes using visual indicators in Git.
- [Interactive Command Interfaces](https://awesome-repositories.com/f/development-tools-productivity/interactive-command-interfaces.md) — Provides a navigable terminal interface with a selection loop for picking emojis via the command line.
- [Git Workflow Utilities](https://awesome-repositories.com/f/development-tools-productivity/git-workflow-utilities.md) — Optimizes the commit process by providing a CLI utility that speeds up the creation of descriptive messages.

### Software Engineering & Architecture

- [Commit History Standardization](https://awesome-repositories.com/f/software-engineering-architecture/commit-history-standardization.md) — Implements a consistent emoji-based categorization system to ensure version control audit logs are human-readable.
- [Commit Message Standards](https://awesome-repositories.com/f/software-engineering-architecture/commit-message-standards.md) — Establishes a standardized system for categorizing code changes using curated emojis in commit messages. ([source](https://cdn.jsdelivr.net/gh/carloscuesta/gitmoji@master/README.md))
- [Visual Categorization Guides](https://awesome-repositories.com/f/software-engineering-architecture/git-version-control-standards/visual-categorization-guides.md) — Ships a curated guide of emojis and descriptions to standardize the meaning of commit messages.
- [Visual Tagging Standards](https://awesome-repositories.com/f/software-engineering-architecture/git-version-control-standards/visual-tagging-standards.md) — Improves the searchability of Git logs by tagging update types with specific visual icons.