@commitlint/cz-commitlint

Commitizen adapter using the commitlint.config.js

@commitlint/cz-commitlint

This is a commitizen adapter, using this adapter, commitizen works based on commitlint.config.js.

Submit by commitizen, lint by commitlint, just need maintain one configuration file, Consistent and Scalable.

The interactive process is inspired by cz-conventional-changelog.

Getting started

Configure commitizen adapter

npm install --save-dev @commitlint/cz-commitlint commitizen inquirer@9  # inquirer is required as peer dependency
# or yarn
yarn add -D @commitlint/cz-commitlint commitizen inquirer@9             # inquirer is required as peer dependency

In package.json

{
  "scripts": {
    "commit": "git-cz"
  },
  "config": {
    "commitizen": {
      "path": "@commitlint/cz-commitlint"
    }
  }
}

Configure commitlint

⚠️ Important: The required version of commitlint and shared configuration is above 12.1.2, update them if already existed in project

# Install commitlint cli and conventional config
npm install --save-dev @commitlint/config-conventional @commitlint/cli
# or yarn
yarn add @commitlint/config-conventional @commitlint/cli -D

# Simple: config with conventional
echo "module.exports = {extends: ['@commitlint/config-conventional']};" > commitlint.config.js

Try it out

git add .
npm run commit
# or yarn
yarn commit

Related

• Commitlint Reference Prompt - How to customize prompt information by setting commitlint.config.js

Changelog

19.4.0 (2024-08-07)

Features

• support command line options from a file (#4109) (a20e890)
• support linting from the last tag (#4110) (4b204ec)