@savvy-web/commitlint

@savvy-web/commitlint

Dynamic, intelligent commitlint configuration that auto-detects DCO requirements, workspace scopes, and versioning strategies. Stop manually configuring commit rules for every project.

Features

• Auto-detection - Detects DCO files, workspace packages, and versioning strategies automatically
• Zero config - Works out of the box with sensible defaults
• Type-safe - Full TypeScript support with Zod schema validation
• Extended types - Includes ai and release commit types beyond conventional commits
• Interactive prompts - Built-in commitizen adapter with emoji support
• CLI tooling - Bootstrap and validate configurations with savvy-commit

Installation

npm install -D @savvy-web/commitlint @commitlint/cli @commitlint/config-conventional husky

Quick Start

// commitlint.config.ts
import { CommitlintConfig } from "@savvy-web/commitlint";

export default CommitlintConfig.silk();

Or use the static configuration without auto-detection:

// commitlint.config.ts
export { default } from "@savvy-web/commitlint/static";

Bootstrap your project automatically with the CLI:

npx savvy-commit init

Claude Code Plugin

This package has a companion Claude Code plugin that will remind your agents of commit standards and provide guidance on checking commits:

# Add the Savvy Web plugin marketplace (one-time setup)
/plugin marketplace add savvy-web/systems

# Install the commitlint plugin for this project
/plugin install commitlint@savvy-web-systems --scope project

Documentation

For configuration options, API reference, and advanced usage, see docs/.

• Configuration Guide - All configuration options
• Auto-Detection - How automatic detection works
• CLI Reference - Command-line interface usage
• Commit Types - Available types and their usage

License

MIT