# Share a source-map-explorer Report — Bundle Size Everyone Can Open

Canonical: https://commareports.com/share-source-map-explorer-report
Published: 2026-08-31

> source-map-explorer --html writes one self-contained treemap. Publish it to Comma so the bundle-size conversation happens on the treemap, not on a screenshot.

# Share a source-map-explorer report

`source-map-explorer` answers the only bundle question that matters — _which
of my dependencies is 400 KB and why is it in the main chunk_ — by reading
your source maps and drawing a treemap of what actually shipped.

The answer is three clicks deep in that treemap, which is why screenshotting
it accomplishes nothing.

## Generate

```bash
npx source-map-explorer 'dist/assets/*.js' --html bundle.html
```

CRA and similar layouts:

```bash
npx source-map-explorer 'build/static/js/*.js' --html bundle.html
```

The `--html` output is a single self-contained file — the treemap library and
the data are both inlined — which makes it the easiest kind of report to
publish.

## Publish it

Drag `bundle.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 bundle.html \
        --arg title "Bundle — $GITHUB_REF_NAME" '{title: $title, html: $html}')"
```

Scripts run inside a sandboxed iframe (`allow-scripts`, no
`allow-same-origin`), so the reviewer can drill in exactly as you can locally.

## Catch regressions with revisions

PATCH one report id on every `main` build. The URL is stable, and each build
appends a revision — so a dependency that quietly doubled in size shows up as
a diff between two treemaps rather than as a support ticket about load times
six weeks later.

Pair it with a size budget in CI: the gate fails the build, the report
explains it.

## What review adds

- **Anchored threads** on a module — "this is the moment/locale bundle, I'll
  swap it" recorded on the rectangle. See
  [commenting on HTML](/comment-on-html).
- **Access per report** — private, team, domain-gated, or named reviewers.
  See the [sharing model](/docs/sharing).

## Limits

- **Entry HTML: 5 MB.** A very large app's inlined treemap data can approach
  this — analyze per entry chunk rather than the whole `dist/` if it does.
- 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 bundle report →](https://commareports.com/)**

### Related

- [Share a bundle analyzer report](/share-bundle-analyzer-report) · [Share a Lighthouse report](/share-lighthouse-report)
- [Share a benchmark report](/share-benchmark-report) · [Share a profiling report](/share-profiling-report)
- [Publish from CI](/docs/ci) · [Interactive HTML reports](/interactive-html-reports)