# Share a Stylelint Report — CSS Findings Someone Can Read

Canonical: https://commareports.com/share-stylelint-report
Published: 2026-09-15

> Stylelint's formatters stop at the terminal. Use the JUnit custom formatter, convert it, and publish to Comma so CSS findings reach the designer who can actually settle them.

# Share a Stylelint report

Most Stylelint findings are trivial. The interesting ones are not lint
problems at all — they are design-system problems: a hex value that should
have been a token, a fourth definition of the same breakpoint, a `z-index` of
9999 that somebody will regret.

The person who can settle those usually does not have the repo checked out.

## JUnit formatter → HTML

```bash
npm i -D stylelint stylelint-junit-formatter
pip install junit2html

npx stylelint "src/**/*.{css,scss}" \
  --custom-formatter node_modules/stylelint-junit-formatter \
  > stylelint.xml || true
junit2html stylelint.xml stylelint.html
```

Custom formatters take a module path rather than a name, which is the part
that trips people up.

## Publish it

Drag `stylelint.html` into [the app](https://commareports.com/), or from CI:

```bash
curl -fsS -X PATCH "https://commareports.com/api/v1/reports/$REPORT_ID" \
  -H "Authorization: Bearer $COMMA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --rawfile html stylelint.html \
        --arg title "Stylelint — $GITHUB_REF_NAME" '{title: $title, html: $html}')"
```

## Getting design into the loop

A link is the only format that reaches somebody without a checkout. Once the
findings are a URL:

- **Anchored threads** on the hard-coded colour — "that's `--surface-2`, I'll
  add it to the token doc" — from the person who owns the token, without a
  seat, a repo or a local Node version. See
  [commenting on HTML](/comment-on-html).
- **Revisions**, so a token migration has a visible finish line.
- **Access per report** — private, team, domain-gated, or named reviewers. See
  the [sharing model](/docs/sharing).

Custom-property rules (`declaration-property-value-no-unknown`,
`custom-property-pattern`) are where this pays off most: they generate the
findings a design system actually cares about.

## Limits

- **Entry HTML: 5 MB.** Assets: 25 MB per file, 250 MB and 500 files total.
- **60 requests/minute per token.**

## Try it

Comma is free — unlimited reports, unlimited commenters, unlimited revision
history.

**[Publish a lint report →](https://commareports.com/)**

### Related

- [Share an ESLint report](/share-eslint-report) · [Share a Biome report](/share-biome-report)
- [Share a Storybook build](/share-storybook-static) · [Share an axe report](/share-axe-report)
- [Share a Percy report](/share-percy-report) · [Publish from CI](/docs/ci)