Commitizen configuration that follows the Conventional Changelog format with emoji support

Downloads in past


201.1.24a year agoa year agoMinified + gzip package size for git-cz-emoji in KB


<a href="">
  <img width="148" height="148" alt="Conventional Emoji Commitizen Config logo" src="" />
The Conventional Commitizen Config with Emoji Support

A configuration managed by Megabyte Labs

<img alt="Homepage" src="" />
<img alt="Contributing" src="" />
<img alt="Slack" src="" />
<img alt="GitHub" src="" />
<img alt="GitLab" src=";base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgAQMAAABJtOi3AAAABlBMVEUAAAD///+l2Z/dAAAAAXRSTlMAQObYZgAAAHJJREFUCNdNxKENwzAQQNEfWU1ZPUF1cxR5lYxQqQMkLEsUdIxCM7PMkMgLGB6wopxkYvAeI0xdHkqXgCLL0Beiqy2CmUIdeYs+WioqVF9C6/RlZvblRNZD8etRuKe843KKkBPw2azX13r+rdvPctEaFi4NVzAN2FhJMQAAAABJRU5ErkJggg==&style=for-the-badge" />

<img alt="Build status" src="">
<img alt="Dependency status reported by Depfu" src="" />
<img alt="Zip file size" src="" />
<img alt="Total downloads of git-cz-emoji on" src="" />
<img alt="Number of vulnerabilities from Snyk scan on git-cz-emoji" src="" />
<img alt="Documentation" src="" />

Commitizen configuration that follows the Conventional Changelog format with emoji support

Table of Contents

- Developer Requirements - Installing Globally - Installing Locally


This project is a shareable Commitizen configuration. It is designed to work alongside git workflows that implement the Conventional Changelog format, Conventional Commits, and adds support for emojis (important for UX). This project borrows heavily from cz-conventional-emoji. It modifies it to include more aethestically pleasing emojis as well as to work seamlessly with the other configurations it is meant to work alongside, namely:
  • semantic-release-config - An all-in-one Semantic Release plugin that supports NPM, Go, Python, and Docker projects (among a few others)
  • conventional-changelog-emoji-config - Configuration for generating files that look good on both GitHub and GitLab as well as accomodate situations where the GitHub/GitLab repository are mirrored


If you are simply including this library in your project, all you need is a recent version of Node.js. Node.js >14.18.0 is sometimes required and is the only version range we actively support. Albeit, it is highly probable that lower versions will work as well depending on the requirements that this project imports.

Developer Requirements

The following versions of Node.js and Python are required for development:
Python >3.10.0
Other versions may work, but only the above versions are supported. Most development dependencies are installed automatically by our Taskfile.yml set-up (even Node.js and Python). Run bash to install Bodega (an improved fork of go-task) and run the initialization sequence. The taskfiles will automatically install dependencies as they are needed, based on what development tasks you are running. For more information, check out the or simply run:
npm run help

npm run help will ensure Bodega is installed and then open an interactive dialog where you can explore and learn about various developer commands.


After you set this configuration up, when you do git commit you will be prompted with an interactive menu. It will prompt you for the type of commit, ask for a subject, and a few other options. The whole process guides your commits and your repository's users commits to come out consistently in such a way that you can generate automated files. semantic-release-config and conventional-changelog-emoji-config rely on this Commitizen configuration to generate commit messages that are in a consistent format.
Some of your commit message titles may look something like:
- ✨ feat: add signup pages from (#11)
- 🐛 fix(test): get browser width for android devices
- ♻️ refactor(sc): refactor to styled component
- 🧪 test: add test for splitmerge


Format of the commit is below:
[emoji] [type]([scope]): [commit msg] (#[issue number])

Note: scope & issue number are optional.


First, ensure
Commitizen (a.k.a. git-cz) is installed. Then, add this package to your system either globally or locally.

Installing Globally

You can install this library globally and have it run on all projects using the following method. First, install the package globally:
npm install --global cz-conventional-emoji

After that, configure Commitizen to use the library by default:
echo '{ "path": "cz-conventional-emoji" }' > ~/.czrc

Installing Locally

To install the library locally (so that the configuration is portable with your repository), add it to your devDependencies by running:
npm i -D cz-conventional-emoji

With the library installed locally, you next have to configure package.json to point to the configuration by adding a section that should look something like this:
  "name": "my_node_module_name",
  "config": {
    "commitizen": {
      "path": "./node_modules/cz-conventional-emoji"


Simply use git cz instead of git commit when committing. See the documentation of Commitizen
for more information.


Contributions, issues, and feature requests are welcome! Feel free to check the issues page. If you would like to contribute, please take a look at the contributing guide.

Dear Awesome Person,

I create open source projects out of love. Although I have a job, shelter, and as much fast food as I can handle, it would still be pretty cool to be appreciated by the community for something I have spent a lot of time and money on. Please consider sponsoring me! Who knows? Maybe I will be able to quit my job and publish open source full time.


Brian Zalewski

Open Collective sponsors GitHub sponsors Patreon


Copyright © 2020-2021 Megabyte LLC. This project is MIT licensed.