Skip to content
Latest

Preview hosting

Attach a static app build so reviewers can open the UI that produced the screenshots.

Upload a preview

Run your visual build first, then upload the static output:

Terminal window
npx vizzly run "npm test"
npx vizzly preview ./dist

If the preview upload runs separately, pass the build explicitly:

Terminal window
npx vizzly preview ./dist --build <build-id>

Private and public projects

For public projects, previews can use direct public URLs.

Private-project previews use signed URLs. Pass --public-link to allow anyone with that link to open the preview.

Terminal window
npx vizzly preview ./dist --public-link

What the CLI supports

Common options:

  • --build
  • --open
  • --dry-run
  • --public-link
  • --base
  • --exclude
  • --include

Troubleshooting

If preview upload cannot find a build, either:

  • run it after vizzly run in the same session
  • pass --build

For parallel CI, run vizzly finalize <parallel-id> first, then pass the finalized build ID with --build if the preview runs in a different session.

Next steps