Skip to content

favoloso/conventional-changelog-emoji

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

@favoloso/conventional-changelog-emoji

Travis CI Coveralls npm

Conventional Changelog with Emojis support πŸŽ‰

Installation

yarn add --dev @favoloso/conventional-changelog-emoji

or

npm install --save-dev @favoloso/conventional-changelog-emoji

Usage

conventional-changelog -p @favoloso/emoji -i CHANGELOG.md -s

Usage with release-it

You can use conventional-changelog plugin (v11+) with the @favoloso/emoji preset.

"release-it": {
  "plugins": {
    "@release-it/conventional-changelog": {
      "preset": "@favoloso/emoji",
      "infile": "CHANGELOG.md"
    }
  }
}

Lint (and fix) commit messages

This package provides an additional bin script emoji-commit-lint.

The scripts lints and eventually changes commit messages, from traditional conventional changelog format (i.e. feat: Add a magic feature) to corresponding emoji (i.e. ✨ Add a magic feature), checks and applies correct casing (i.e. lower-case) and many more, as configured by Linter Rules.

To use it, install husky

yarn add --dev husky

Now in your package.json add:

{
  "husky": {
    "hooks": {
      "commit-msg": "emoji-commit-lint"
    }
  }
}

Now linter will check your commits. Any commit like <type>: <msg> will be automatically transformed with related emoji. See Available Emojis to see available types.

Configuration

The package works as-is, but its behaviour may be customized with the following options.

Note: This package supports cosmiconfig to provide configuration options with favolosoEmoji module name.

  • emojis (default: {})

    An object allowing you to customize conventional-changelog types used (as Available Emojis table).

    You should provide an object, where the key is the type you want to edit (or add), and the value is the updated configuration. Configurations will be merged with originals if existing.

    See the Custom Emoji wiki page for further details.

  • rules (default: {})

    Allows to customize linter rules. See the Linter Rules wiki page for further details.

  • showEmojiPerCommit (default: false)

    In the changelog, shows emoji for each commit. In the default mode (false), emojis are omitted from commits and only the heading contains them (i.e. πŸ› Bug Fixes)

  • minorForBreakingInDevelopment (default: true)

    Breaking changes during development will be considered as minor instead of major bumps (see semver spec).

    1. Major version zero (0.y.z) is for initial development. Anything may change at any time. The public API should not be considered stable.
  • language (default: en)

    Allows to translate commits group heading in CHANGELOG.md (i.e. πŸ› Bug Fixes) and in linter messages. Languages available: en, it

Example config in package.json

{
  "favolosoEmoji": {
    "showEmojiPerCommit": false
  }
}

Available Emojis

Emoji Aliases Type Type Aliases Version Bump In Changelog? Heading Order
🚨 breaking major βœ… 🚨 Breaking Changes 10
✨ 🌟, πŸ’«, 🌠 feat minor βœ… ✨ Features 20
πŸ”’ security patch βœ… πŸ”’ Security 25
πŸ›  improvement imp patch βœ… πŸ›  Improvements 30
⚑️ perf performance patch βœ… ⚑️ Performance 35
πŸ› 🐞 fix patch βœ… πŸ› Bug Fixes 40
πŸ“š πŸ“– docs doc patch βœ… πŸ“š Documentation 50
πŸ— βš™οΈ chore chores patch βœ… πŸ— Chore 60
♻️ refactor patch ♻️ Refactoring 90
🚦 βœ… test patch 🚦 Test 90
🎨 πŸ’„ style cleanup patch 🎨 Style 90
πŸ“¦ build deps patch πŸ“¦ Build 90
πŸ”– release patch πŸ”– Release 90
🚧 wip patch 🚧 Wip 90