@spellbookx/commitlint-config

@spellbookx/commitlint-config

Shared Commitlint configuration — standardizing commit message formatting across JS/TS projects.
Conventional commits, interactive prompts, and multi-scope support included.
Clean. Opinionated. Always consistent.

Table of Content

• Features
• Install
• Usage
• With CLI
• With Lefthook
• Resources
• License

Features

• Base Rules

  • Enforces Conventional Commits style.
  • Supported commit types:
    • feat → A new feature
    • fix → A bug fix
    • docs → Documentation only changes
    • style → Code style changes without functional impact
    • refactor → Code refactoring (no feature or fix)
    • perf → Performance improvements
    • test → Adding or correcting tests
    • build → Changes affecting the build system or dependencies
    • ci → Changes to CI configuration
    • chore → Miscellaneous chores
    • revert → Reverts a previous commit
  • Enforces:
    • Scope case: kebab-case
    • Subject cannot be empty
    • Subject case: sentence-case
    • No full stop at the end of subject
    • Header max length: 72
    • Body and footer max line length: 100

• Interactive Prompt

  • Multi-scope support enabled
  • Scope separator: ,
  • Guided questions for type, scope, subject, body, breaking changes, and issues affected
  • Emoji and title per commit type
  • Uses cz for interactive commits (npx cz)

• Parser Preset

  • Uses conventional-changelog-conventionalcommits
  • Supports multi-scope commit messages:

    type(scope1,scope2): subject
    

Installation

npm install -g commitizen cz-git
npm install -D commitizen cz-git conventional-changelog-conventionalcommits @commitlint/cli @commitlint/config-conventional @spellbookx/commitlint-config

or

pnpm add -g commitizen cz-git
pnpm add -D commitizen cz-git conventional-changelog-conventionalcommits @commitlint/cli @commitlint/config-conventional @spellbookx/commitlint-config

or

yarn global add commitizen cz-git
yarn add -D commitizen cz-git conventional-changelog-conventionalcommits @commitlint/cli @commitlint/config-conventional @spellbookx/commitlint-config

or

bun add -g commitizen cz-git
bun add -D commitizen cz-git conventional-changelog-conventionalcommits @commitlint/cli @commitlint/config-conventional @spellbookx/commitlint-config

Usage

Create a commitlint.config.mjs file at your project root:

export default {
  extends: ['@spellbookx/commitlint-config'],
};

Create a .czrc file at your project root:

{
  "path": "cz-git"
}

Add these properties to your root package.json:

{
  "config": {
    "commitizen": {
      "path": "git-cz"
    }
  }
}

With CLI

Interactive commits using Commitizen:

npx cz

With Lefthook

Configure a lefthook.yml in your project root:

commit-msg:
  commands:
    lint-commit-msg:
      run: npx commitlint --verbose --edit {1}

Commitlint will automatically validate commit messages on each commit. Use cz to create commits interactively.

Resources

• Commitlint Documentation
• Conventional Commits
• Commitizen

License

This project is licensed under the MIT License.

Copyright (c) 2025 Davide Di Criscito

For the full details, see the LICENSE file.