@commitlint/lint

What is @commitlint/lint?

The @commitlint/lint package is a part of the commitlint toolset that is used to lint commit messages according to a specified set of rules. It helps maintain a consistent commit history and enforces a commit message convention, which is beneficial for automated processing of commit logs, generating changelogs, and aiding in code reviews.

What are @commitlint/lint's main functionalities?

Linting Commit Messages

This feature allows you to lint commit messages using a set of predefined rules. The code sample demonstrates how to use the lint function to check if a commit message follows the specified rules for the commit type and subject case.

const { lint } = require('@commitlint/lint');
const message = 'feat: add new feature';
const rules = {
  'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore']],
  'subject-case': [2, 'never', ['start-case', 'pascal-case', 'upper-case']]
};

lint(message, rules).then(report => {
  console.log(report);
});

Other packages similar to @commitlint/lint

commitlint

commitlint is the core package that includes @commitlint/lint as part of its toolset. It provides a CLI and can be extended with plugins and shareable configurations. It is essentially the same tool but with a broader scope.

conventional-changelog-lint

conventional-changelog-lint is a predecessor to commitlint and offers similar functionality for linting commit messages based on the conventional changelog standard. It has been deprecated in favor of commitlint.

validate-commit-msg

validate-commit-msg is another deprecated package that was used to validate commit messages. It has been replaced by commitlint, which offers a more modern and flexible approach to commit message validation.

README

@commitlint/lint

Lint a string against commitlint rules

Getting started

npm install --save @commitlint/lint

Documentation

Consult API docs for comprehensive documentation.

Documentation generated from docs folder.

Changelog

19.8.1 (2025-05-08)

Bug Fixes

• update dependency tinyexec to v1 (#4332) (e49449f)
• update dependency tinyexec to v1.0.1 (#4347) (c1b26d1)

Performance Improvements

• rules: optimize header-trim (#4363) (b7e404b)