kevin940726/emoji-cz

:sparkles: A commitizen emoji adapter.

emoji-cz

A commitizen emoji adapter.

? Select the type of change that you're committing: (Use arrow keys)
❯ ✨  Feat:      A new feature
  🐛  Fix:       A bug fix
  📚  Docs:      Documentation only changes
  🎨  Style:     Changes that do not affect the meaning of the code
  🔨  Refactor:  A code change that neither fixes a bug nor adds a feature
  🚀  Perf:      A code change that improves performance
  🚨  Test:      Adding missing tests or correcting existing tests

Demo

Just check out the commit history above ☝️

Installation

yarn global add emoji-cz
# OR
# npm install --global emoji-cz

# set as default adapter globally
echo '{ "path": "emoji-cz" }' > ~/.czrc

Usage

Simply use git cz instead of git commit when committing. See the doc of Commitizen for more info.

Settings

You can overwrite the settings in 3 different ways, it will apply the config by this order:

1. package.json
2. .cz.json
3. .czrc

// in package.json
"config": {
  "commitizen": {
    // ...
    "emoji-cz": {
      // Overwrite types prompted to the command line.
      "types": {
        "Fix": {
          "emoji": "🐝", // overwrite "Fix" emoji to a bee
          "name": "Bug", // overwrite "Fix" name to "Bug"
          "description": "Dirty bug" // overwrite description of "Fix"
        },
        // add a new type "Chore"
        "Chore": {
          "emoji": "❓",
          "description": "Other changes that don't modify src or test files"
        }
      },

      // Overwrite the output commit subject in the specified format.
      // Below is the default format,
      // [emoji] will be replace with the chose type's emoji,
      // [name] will be replace with the chose type's name,
      // [subject] will be replace with the subject you entered.
      // One example output of the format can be: `✨ Feat: initial commit`
      "format": "[emoji] [name]: [subject]"
    }
  }
}

// in .cz.json or .czrc
{
  "emoji-cz": {
    //...
  }
}

Author

Kai Hao [email protected]

License

MIT

emoji-cz's Issues

Can I translate your project in Korean?

I translated your project to Korean version.
https://github.com/devjiro76/emoji-cz-kr

Sorry about I didn't ask you before fork.
Question is late but can I translate your project in Korean?
If you mind I'll delete this repo.

Consider switching to lowercase types

Currently this package uses Titlecase types (Feat, Docs etc). Tools like semantic-release rely on all lowercase types to generate releases.

Consider switching to all lowercase types (feat, docs and so on) so that it works better with other tools.

Maybe an option to switch to Titlecase (default lowercase and option to switch to Titlecase or vice versa) will also be good - although I guess its more work for not much benefit.