SCSS Lint HTML Reporter

0.4.2 verified Fri May 01 auth: no javascript

Generates HTML reports (full or lite) from SCSS Lint JSON output, with optional TeamCity integration. Stable version 0.4.2, low maintenance cadence. Differentiators: supports both detailed and summary HTML reports, and can output TeamCity service messages for CI/CD integration.

Common errors

error scss-lint: command not found ↓

cause SCSS Lint not installed or not in PATH.

fix

Install SCSS Lint via Ruby: gem install scss-lint

error ENOENT: no such file or directory, open 'scss-lint-report.html' ↓

cause Output file path could not be written (e.g., missing directory permissions).

fix

Specify a writable path with -o, or run from a directory where you have write access.

Warnings

gotcha The reporter expects SCSS Lint JSON format. If SCSS Lint is not installed or output is not JSON, the reporter will fail silently or produce an empty report. ↓

fix Ensure SCSS Lint is installed and the -f JSON flag is used.

gotcha --nohtml without --teamcity will produce no output (no HTML, no TeamCity). ↓

fix Use --teamcity along with --nohtml to get TeamCity output only.

deprecated The package uses hairballs internally (an older version). No breaking changes reported, but consider alternative tools like stylelint. ↓

fix No fix needed, but stylelint can replace SCSS Lint and has its own reporters.

Install

npm install scss-lint-html-reporter

yarn add scss-lint-html-reporter

pnpm add scss-lint-html-reporter

Imports

reporter (binary)
wrong
```
scss-lint -f JSON | reporter
```
correct
```
scss-lint -f JSON | node node_modules/scss-lint-html-reporter/bin/reporter.js
```
The reporter is a CLI binary, not a JavaScript module. Run via npx or path to bin/reporter.js.

Quickstart

Run SCSS Lint with JSON formatter and pipe output to the reporter to generate an HTML report.

scss-lint -f JSON | node node_modules/scss-lint-html-reporter/bin/reporter.js -o my-report.html