Lint commit messages

Demo generated with svg-term-cli

cat docs/assets/commitlint.json | svg-term --out docs/assets/commitlint.svg --frame --profile=Seti --height=20 --width=80

commitlint

🚓 Be a good commitizen
📦 Share configuration via npm
🤖 Tap into conventional-changelog

Getting started
CLI
Config
Shared configuration
API
Tools
Roadmap
Version Support
Related projects
License
Development
- Install and run
- Publishing a release

Getting started

# Install commitlint cli and conventional config
npm install --save-dev @commitlint/{config-conventional,cli}
# For Windows:
npm install --save-dev @commitlint/config-conventional @commitlint/cli

# Configure commitlint to use conventional config
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js

To lint commits before they are created you can use Husky's 'commit-msg' hook:

{
  "husky": {
    "hooks": {
      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }  
  }
}

Detailed Setup instructions

Local setup - Lint messages on commit with husky
CI setup - Lint messages during CI builds

CLI

Primary way to interact with commitlint.
npm install --save-dev @commitlint/cli
Packages: cli

Config

Configuration is picked up from commitlint.config.js, .commitlintrc.js, .commitlintrc.json, or .commitlintrc.yml file or a commitlint field in package.json
Packages: cli, core
See Rules for a complete list of possible rules
An example configuration can be found at @commitlint/config-conventional

Shared configuration

A number of shared configurations are available to install and use with commitlint:

⚠️ If you want to publish your own shareable config then make sure it has a name of this patter commitlint-config-emoji-log or commitlint-config-your-config-name — then in extend all you have to write is emoji-log or your-config-name.

API

Alternative, programmatic way to interact with commitlint
Packages:
- format - Format commitlint reports
- lint - Lint a string against commitlint rules
- load - Load shared commitlint configuration
- read - Read commit messages from a specified range or last edit
See API for a complete list of methods and examples

Tools

Roadmap

Ideas: marionebl/commitlint#94

commitlint is considered stable and is used in various projects as development tool.

We identify ease of adoption and developer experience as fields where there is room and need for improvement. The items on the roadmap should enhance commitlint regarding those aspects.

Adoption: Provide reusable Travis CI integration: @commitlint/travis-cli (https://github.com/marionebl/commitlint/releases/tag/v5.1.0)
DX: Support PR squash scenario via ahmed-taj/commitlint-bot and @commitlint/travis-cli
Adoption: Make ahmed-taj/commitlint-bot configurable via commitlint configuration
Adoption: Create commitlint init
DX: Extend the configuration schema to allow for additional fields (descriptions, examples, fixes) on both the rule and value level
DX: Incorporate an extended version of lennym/commit-template deducing a template from commitlint configuration
DX: Rewrite @commitlint/prompt for better usability (might involve a lot of yak-shaving)

Version Support

Node.js LTS >= 6
git >= 2

Related projects

conventional-changelog – Generate a changelog from conventional commit history
commitizen – Simple commit conventions for internet citizens
create-semantic-module – CLI for quickly integrating commitizen and commitlint in new or existing projects
commitlint.io - helps your project to ensures nice and tidy commit messages without needing any download or installation

License

Development

commitlint is developed in a mono repository.

Install and run

git clone git@github.com:marionebl/commitlint.git
cd commitlint
npx yarn install
npx yarn run build # run build tasks
npx yarn start # run tests, again on change

For more information on how to contribute please take a look at our contribution guide.

Publishing a release

npx yarn run clean
npx yarn install
npx yarn run build
npx yarn test
npx yarn run publish

karolisgrinkevicius/commitlint