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 โญ๏ธ

Profile picture

Lead developer at Pix.
I'm NantesJS co-organizer on my spare time.

Twitterย .ย Github

ยฉ 2023, Built with Gatsby