# Share a Gatsby Site Preview — Publish public/ Without a Deploy

Canonical: https://commareports.com/share-gatsby-site
Published: 2026-09-01

> gatsby build writes a static public/ directory. Publish it to Comma for a private preview link with anchored comments and a revision per build, instead of provisioning hosting for a review.

# Share a Gatsby site preview

`gatsby build` produces `public/`, a complete static site, and then the
review turns into an infrastructure question. Which is a strange outcome
for a directory of files whose entire purpose is to be served by anything.

## Publish the build

```bash
gatsby build
```

Drag `public/` (or a zip of it) into [the app](https://commareports.com/):

- `index.html` becomes the report body.
- JS, CSS, fonts and the build-time image variants upload as assets with
  their references rewritten to the uploaded copies — the step that
  separates a working preview from
  [a page with broken CSS](/html-report-broken-css).
- Scripts run inside a sandboxed iframe, so hydration, the nav and
  client-side transitions between prerendered routes keep working.

Leave `pathPrefix` unset for a preview build. It bakes in a path the
preview is not being served under.

## Private by default

Every report is private until you change it: team, email-domain gate,
named reviewers, or a
[password-protected link](/password-protect-html-report) for a client.
See the [sharing model](/docs/sharing). Which is a thing a quick static
deploy usually does not give you without extra work.

## Feedback lands on the page

The point of a preview is corrections, and corrections in an email are a
to-do list you have to translate back into locations.

- **Anchored threads** on the paragraph, the image, the nav item — see
  [commenting on HTML](/comment-on-html).
- **Revisions.** Rebuild, PATCH the same report id, and the reviewer sees
  the new build at the URL they already have.
- **An agent can read the comments back** through [MCP](/docs/mcp) when
  the edits are being made by Claude Code rather than you.

## Limits

- **Entry HTML: 5 MB.** Assets: 25 MB per file, **250 MB and 500 files
  total** — a Gatsby build with responsive image variants generates a lot
  of files and passes 500 easily on a media-heavy site. Build a subset
  for review when it does.
- **60 requests/minute per token.**

## Try it

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

**[Create your first report →](https://commareports.com/)**

### Related

- [Next.js static exports](/share-nextjs-static-export) · [Nuxt](/share-nuxt-static-site)
- [Astro](/share-astro-site) · [Hugo](/share-hugo-site) · [Jekyll](/share-jekyll-site)
- [Share with a client](/share-html-file-with-client) · [Publish from CI](/docs/ci)