kvalita

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

Use the --extends flag in your CI workflow:

- name: Release
  run: bunx semantic-release --extends kvalita/semantic-release

This configuration includes:

• Branches: main, next (prerelease), beta (prerelease), alpha (prerelease)
• conventionalcommits preset with feat!: syntax for breaking changes
• npm provenance (requires id-token: write permission)

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)

Agentic Coding

Skills

This package includes agent skills for code formatting and test writing conventions.

Available skills:

• formatting - Code formatting rules not handled by auto-formatters (arrow functions, exports, types, naming, comments, JSX)
• testing - Best practices, structure, coverage categories, and formatting conventions for writing tests

To make them available globally in Claude Code, symlink the skills directory:

ln -s /path/to/kvalita/skills/formatting ~/.claude/skills/formatting
ln -s /path/to/kvalita/skills/testing ~/.claude/skills/testing