Yvonnick Frin

moon indicating dark mode
sun indicating light mode

A changelog generator for gitmoji convention

July 10, 2019


It is a commit message convention created by Carlos Cuesta 😎. It describes the purpose of this convention on gitmoji’s repository on GitHub:

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.


With Benjamin Petetot and Fabien Juif we worked on a command line tool that generates changelog files for javascript projects following gitmoji convention. We simply named it gitmoji-changelog πŸ˜€.

gitmoji-changelog usage

Here is an example of generated changelog using gitmoji-changelog

You can find out more about usage on our repository πŸ‘Œ!

2.0 is in alpha πŸŽ‰

gitmoji-changelog is still evolving. We are currently working on a version 2.0.0 πŸ’ͺ It is already available in alpha πŸŽ‰

You can find out new features in our changelog πŸ˜‰!

To test it you can install the alpha version:

npm install -g gitmoji-changelog@alpha

Feedback or ideas are appreciated πŸ™ Please tweet me if you have questions @YvonnickFrin!

Want to support ? Don’t forget to leave a ⭐️

Found a typo or you want to suggest improvements?

Feel free to edit this article on GitHub.

Yvonnick Frin
Open source advocate at @ZenikaIT.
I'm a @NantesJS co-organizer on my spare time.

Related projects


A changelog generator for gitmoji 😜

Read more