Share a sitespeed.io report
sitespeed.io produces the most complete performance artifact in the open source world — metrics, waterfalls, a filmstrip, a video of the load — and delivers it as a directory that only makes sense over HTTP:
sitespeed-result/example.com/2026-08-30-09-14-22/
index.html
pages/… # per-URL detail
data/… # HARs, budget results
video/… # capture, if enabled
So the performance conversation happens over a screenshot of a number, and the waterfall that explains the number stays on someone's laptop.
Publish the run
npx sitespeed.io https://example.com -n 5 --video false
Drag the timestamped run directory (or a zip of it) into the app:
index.htmlbecomes the report body.- Pages, charts, HARs and screenshots upload as assets with their relative references rewritten to the uploaded copies.
- Scripts run inside a sandboxed iframe, so the graphs and the waterfall interactions work.
Trim before you publish. --video false is the single biggest saving;
the per-file cap is 25 MB and the run total is 250 MB across 500 files, and a
video capture across five runs will eat both.
From CI, against one report id
npx sitespeed.io https://example.com --budget.configPath budget.json || true
zip -qr result.zip sitespeed-result
# PATCH the same report id — see /docs/ci for the full recipe
One URL per environment, one revision per run. A budget breach is then a diff between revisions instead of an alert nobody can contextualize.
What the review layer adds
- Anchored threads on the offending request in the waterfall — "this third-party tag is the 400 ms, marketing owns it". See commenting on HTML.
- Revisions so "did the CDN change help?" is answerable.
- Access per report — private, team, domain-gated, or named reviewers. See the sharing model.
Keep it running
Performance regressions arrive on someone else's deploy schedule. A routine runs the measurement on a cron, PATCHes the same report, and notifies subscribers when it moves.
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 performance report →