cz-conventional-commit-with-clickupid-detection

This is a fork of cz-conventional-changelog-with-jiraid-detection by Daw-Chih Liou, modified to detect ClickUp IDs instead of Jira IDs while maintaining the same functionality.

Originally a fork of cz-conventional-changelog.

Prompts for conventional changelog standard with an extra step to insert ClickUp ID. ClickUp ID is auto-detected from your branch name by default.

ClickUp ID in the format of /^[a-z0-9]{9}$/, "86b4f61zg" for example, will be automatically detected from the current branch name and be displayed as default at the prompt step. The step is optional so you can skip it if you do not have a ClickUp ID.

Install

with npm

npm install --save-dev cz-conventional-changelog-with-clickupid-detection

or with yarn

yarn add --dev cz-conventional-changelog-with-clickupid-detection

To enable it, please update your package.config as the following

"config": {
    "commitizen": {
      "path": "./node_modules/cz-conventional-changelog-with-clickupid-detection"
    }
  },

Features

• 🔥 It works with semantic-release and Standard Version right out of the box.
• 💚 It share the same configurtion with commitlint's default configuration.
• 💆‍♀️ It prompts an optional step for inserting your ClickUp ID.
• 🤖 It automatically detects ClickUp ID from your current branch name and display it as default value at the prompt step.
• 📝 ClickUp ID is composed at the start of your commit's head.

Configuration

package.json

Like commitizen, you specify the configuration of cz-conventional-changelog through the package.json's config.commitizen key.

{
// ...  default values
    "config": {
        "commitizen": {
            "path": "./node_modules/cz-conventional-changelog",
            "disableScopeLowerCase": false,
            "disableSubjectLowerCase": false,
            "maxHeaderWidth": 100,
            "maxLineWidth": 100,
            "defaultType": "",
            "defaultScope": "",
            "defaultSubject": "",
            "defaultBody": "",
            "defaultIssues": "",
            "types": {
              ...
              "feat": {
                "description": "A new feature",
                "title": "Features"
              },
              ...
            }
        }
    }
// ...
}

Environment variables

The following environment variables can be used to override any default configuration or package.json based configuration.

• CZ_TYPE = defaultType
• CZ_SCOPE = defaultScope
• CZ_SUBJECT = defaultSubject
• CZ_BODY = defaultBody
• CZ_MAX_HEADER_WIDTH = maxHeaderWidth
• CZ_MAX_LINE_WIDTH = maxLineWidth

Commitlint

If using the commitlint js library, the "maxHeaderWidth" configuration property will default to the configuration of the "header-max-length" rule instead of the hard coded value of 100. This can be ovewritten by setting the 'maxHeaderWidth' configuration in package.json or the CZ_MAX_HEADER_WIDTH environment variable.