@krema/angular-eslint-stylelint-builder

Angular ESLint + Stylelint Builder

A unified Angular CLI builder for linting Angular projects with ESLint and Stylelint in a single step.

Version Compatibility

The table below outlines the compatible versions for Angular, Stylelint, and ESLint with each major release of our tool:

Version	Angular	Stylelint	ESLint
v1.x	9–15	≤15	≤8
v2.x	16–17	16+	9+
v3.x	18+	16+	9+

Features

• Lint both TypeScript and stylesheets in one command
• Supports ESLint and Stylelint configuration and ignore patterns
• Output to file or console, with multiple formatter options
• Caching for faster linting
• Fine-grained control over warnings, errors, and exit codes

Prerequisites

• Angular CLI project (v9+)
• ESLint and Stylelint installed and configured (e.g., eslint.config.js for flat config, or .eslintrc for legacy config, and stylelint.config.js for Stylelint)

Installation

npm install --save-dev @krema/angular-eslint-stylelint-builder

Usage

• Update your angular.json

  Replace the default lint builder with this one:

  "lint": {
    "builder": "@krema/angular-eslint-stylelint-builder:lint",
    "options": {
      "eslintFilePatterns": ["**/*.ts"],
      "stylelintFilePatterns": ["**/*.scss"]
    }
  }
  

• Run linting

  ng lint
  

Configuration Options

Name	Default	Description	Required	Linter
Basic configuration:
eslintFilePatterns	[]	Files/globs for ESLint	Yes	eslint
eslintConfig		Path to ESLint config (supports both flat config eslint.config.js and legacy .eslintrc.*)	No	eslint
stylelintFilePatterns	[]	Files/globs for Stylelint	Yes	stylelint
stylelintConfig		Path to Stylelint config (stylelint.config.js or legacy .stylelintrc.*)	No	stylelint
noEslintrc	false	Disable .eslintrc.* and package.json config	No	eslint
fix	false	Auto-fix fixable issues	No	both
Cache-related:
eslintCache	false	Enable ESLint cache	No	eslint
stylelintCache	false	Enable Stylelint cache	No	stylelint
eslintCacheLocation	.eslintcache	ESLint cache file/directory	No	eslint
stylelintCacheLocation	.stylelintcache	Stylelint cache file/directory	No	stylelint
eslintCacheStrategy	metadata	ESLint cache strategy (metadata or content)	No	eslint
File Enumeration:
eslintIgnorePatterns	[]	Glob patterns to ignore (ESLint 9+)	No	eslint
stylelintIgnorePatterns	[]	Glob patterns to ignore (Stylelint 16+)	No	stylelint
Output:
outputFile		Write report to file instead of console	No	both
format	stylish	Output formatter (see ESLint formatters)	No	both
silent	false	Hide output text	No	both
Handling warnings:
quiet	false	Only show errors (ignore warnings)	No	both
maxWarnings	-1	Max warnings before nonzero exit code	No	both
force	false	Succeed even if there are lint errors	No	both

Example

"lint": {
  "builder": "@krema/angular-eslint-stylelint-builder:lint",
  "options": {
    "eslintFilePatterns": ["src/**/*.ts"],
    "stylelintFilePatterns": ["src/**/*.scss"],
    "fix": true
  }
}

License

MIT

Changelog

3.0.1 (2025-07-26)

Bug Fixes

• deps: correct Angular peerDependencies ranges (18509fb)

Features

• stylelint: migrate to ESM for Stylelint to remove CommonJS API usage (b531925)

BREAKING CHANGES

• stylelint: The CommonJS Node.js API for Stylelint has been deprecated and will be removed in the next major release. This commit updates @krema/angular-eslint-stylelint-builder and related configurations to utilize Stylelint's ECMAScript Modules (ESM) API.

Plugin authors or users of stylelint.lint() directly within their projects may need to adjust their imports or configurations to use ESM. Custom syntaxes and formatters are not affected.

The previous DeprecationWarning: The CommonJS Node.js API is deprecated message on ng lint will no longer appear.

See Stylelint migration guide: https://stylelint.io/migration-guide/to-16

chore(test): convert to vitest

ci(actions): disable fail fast