@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.2 (2025-07-26)

Bug Fixes

• deps: correct Angular peerDependencies ranges (5e17307)