Use the file you already have.
Share a self-contained HTML prototype, generated analysis, or visual report directly from your working directory. Viewable accepts one HTML file per share, up to 5 MiB.
Share an HTML file
Share an HTML file with a private review link.
When an agent gives you a self-contained HTML prototype, report, or dashboard, Viewable turns that local file into a browser link. Your recipient opens the result without cloning a repository or setting up a deployment project.
One file to one review link
npm$ npx @viewable/cli share ./prototype.html
✓ Shared privately
Input: prototype.html. Output: a private URL and a separate access code.
Give reviewers a page, not an attachment.
The recipient opens an interactive browser view with a link and access code. They do not need a Viewable account, a code editor, or instructions for opening a downloaded file.
Keep deployment for production work.
Viewable is for temporary human review. Use your production hosting platform when the page needs a repository, build pipeline, custom domain, backend, or public application lifecycle.
Workflow
From local file to human review.
- 01
Choose the file
Use one self-contained .html file. Inline the styles and scripts the preview needs instead of relying on local project paths.
- 02
Run the share command
Run the CLI from the directory that contains the file. Guest sharing works without signing in first.
- 03
Send private access
Send the returned URL and access code to the intended reviewer. Delete the share when the review is finished.
Details
What to know before sharing.
- Does the HTML stay interactive?
- Self-contained scripts, forms, and interactions can run inside a sandboxed browser frame. The page does not inherit access to the Viewable application.
- Will local assets load?
- No. Paths that only exist on your machine are not uploaded automatically. Package required styles, scripts, and images into the single HTML file or use reachable remote assets.
- Does the reviewer need an account?
- No. A reviewer opens the share with the URL and access code supplied by the sender.
- How long does a Guest share last?
- A Guest share expires seven days after its latest successful share or update. Signing in can claim active Guest shares for account management.
Related guides