@angular-eslint/builder

@angular-eslint/builder

Please see https://github.com/angular-eslint/angular-eslint for full usage instructions and guidance.

The @angular-eslint/builder package is a custom Angular CLI builder that allows you to run ESLint on your Angular CLI projects.

It wraps the ESLint programmatic node API (https://eslint.org/docs/latest/integrate/nodejs-api) to provide a seamless experience via ng lint that is closely equivalent to using the eslint CLI directly.

Performance statistics

You can profile rule execution times by enabling ESLint's stats output:

ng lint --stats

Bulk suppressions

ESLint introduced bulk suppressions in v9.24. This allows you to enable new lint rules without having to fix every existing violation first. For details, see https://eslint.org/docs/latest/use/suppressions. In ESLint v10.1 a subset of the suppressions functionality was added to the Node.js API (https://eslint.org/blog/2026/03/eslint-v10.1.0-released/#api-support-for-bulk-suppressions).

You can now apply suppressions that were previously generated with the ESLint CLI. You can also set the location of the suppressions file that should be used. Currently it is not possible to create new suppressions or prune suppressions via the Node.js API (https://eslint.org/docs/latest/use/suppressions#usage-with-the-nodejs-api). This has to be done by using the ESLint CLI.

To apply suppressions you have to either use the CLI flag

ng lint --apply-suppressions --suppressions-location="/path/to/eslint-suppressions.json"

or add the option in angular.json:

...
        "lint": {
          "builder": "@angular-eslint/builder:lint",
          "options": {
            "applySuppressions": true,
            "suppressionsLocation": "/path/to/eslint-suppressions.json"
          }
        }
...

The suppressionsLocation defaults to {workspaceRoot}/eslint-suppressions.json.

While setting suppressionsLocation without applySuppressions is allowed (because it could be used with --suppress-all in the future), it currently does nothing.