Kvalita

Shared linter configurations for TypeScript projects.

Kvalita provides reusable, opinionated configurations for maintaining consistent code quality across TypeScript projects.

Installation

bun add -d kvalita

This will automatically install all required dependencies.

[!NOTE] All tools are installed together for simplicity, even if you only use some of the configurations. This ensures all CLIs and configs work correctly and avoids resolution issues.

Usage

Biome Configuration

Create a biome.json file in your project root:

{
  "extends": ["kvalita/biome"]
}

Commitlint Configuration

Create a commitlint.json file in your project root:

{
  "extends": ["./node_modules/kvalita/configs/commitlint.json"]
}

Semantic Release Configuration

Create a release.json file in your project root:

{
  "extends": "kvalita/semantic-release"
}

This configuration uses the conventionalcommits preset, which supports the feat!: syntax for breaking changes.

Lefthook Configuration

Create a lefthook.json file in your project root and extend the hooks you need:

{
  "extends": [
    "node_modules/kvalita/configs/lefthook-biome.json",
    "node_modules/kvalita/configs/lefthook-typescript.json",
    "node_modules/kvalita/configs/lefthook-commitlint.json"
  ]
}

Available hooks:

• lefthook-biome.json - Lints and formats staged files with Biome (pre-commit)
• lefthook-typescript.json - Type checks TypeScript files (pre-commit)
• lefthook-commitlint.json - Validates commit messages (commit-msg)