Which frameworks are supported?

PreviewShip works with any static frontend output — React, Vue, Svelte, Angular, Next.js (export), vanilla HTML/CSS/JS, and more. Build output folders with index.html and single .html files can be deployed.

How do I upload an HTML file to a website?

Use PreviewShip to upload a .html file in the console, paste a complete HTML document, or run npx previewship deploy ./page.html from the CLI. PreviewShip packages the file as index.html and returns a public HTTPS URL.

Does PreviewShip provide HTML file hosting?

Yes. PreviewShip hosts browser-ready static artifacts, including standalone HTML files, pasted HTML source, generated HTML reports, and build output folders that contain index.html and assets.

Can I publish AI-generated HTML with PreviewShip?

Yes. Paste HTML source in the console, upload a .html file, or deploy ./report.html with CLI, MCP, VS Code, or Cursor. PreviewShip returns a public preview URL.

How do I share a Claude HTML artifact?

Use PreviewShip MCP when Claude Code should deploy directly, or use the CLI with npx previewship deploy. Both workflows return a live URL that can be shared with reviewers.

Can I host a single HTML file?

Yes. Upload a .html file, paste HTML source, or deploy it from CLI, MCP, VS Code, or Cursor. PreviewShip packages it as a browser-ready index.html preview.

How do I deploy from an AI coding agent?

Add the PreviewShip MCP server to your agent (Claude Code, Cursor, Windsurf), or use the CLI with --json flag. Your agent can deploy previews as part of the conversation using the Model Context Protocol (MCP).

What's the difference between CLI and MCP?

The CLI is a terminal command (npx previewship deploy). MCP is a protocol that lets AI agents call deploy as a native tool. Use CLI for scripts and manual deploys, MCP for seamless agent integration.

Is there a free tier?

Yes. The Free plan includes 5 deploys per day, 20 per month, and 1 project. No credit card is required. Pro costs $8.10/month or $75.60/year by default; eligible Brazil and Portugal checkout regions receive regional pricing of $5.40/month or $50.40/year.

How long do preview URLs stay active?

Guest preview URLs expire after 24 hours. Account deployments also have plan-specific retention: Free previews expire after 3 days, while paid plans retain previews longer. PreviewShip shows the exact expiry for each deployment.

Can I use PreviewShip with VS Code or Cursor?

Yes! PreviewShip has official extensions for both VS Code and Cursor. Install from the VS Code Marketplace or Open VSX, then deploy with one click from your editor. You can also configure the MCP server for AI-assisted deployment in Cursor.

What is the Model Context Protocol (MCP)?

MCP is an open protocol that allows AI coding agents to use external tools natively. PreviewShip's MCP server lets agents like Claude Code, Cursor, and Windsurf deploy frontend previews as part of the coding conversation — no copy-pasting commands needed.

How does PreviewShip compare to Vercel or Netlify?

PreviewShip is purpose-built for quick preview sharing, not full production hosting. Unlike Vercel or Netlify, it requires no Git integration or CI/CD setup. Just deploy a folder and share the link — perfect for AI-assisted development workflows, design reviews, and client approvals.

Static page to shareable link

Upload a Static Page, Get a Shareable Link in Seconds

Publish an HTML, Markdown, or PDF file, a ZIP, or a built static site and get a link you can share right away. No domain, server, or Git setup required.

Start Deploying — It's Free Log in Showcase gallery

Deploy preview

PreviewShip

Artifact to live URL.

Browser-ready output becomes a review link without Git setup.

Input

dist/index.html

Deploy

previewship deploy --json

https://demo.previewship.net

Run status

Validated artifact

Generated route

Synced edge

Ready to share

Formats

BuildHTMLMDPDF

Result

demo.preview...

Input

dist/build/out/public, zip, .html, .md, .pdf, or pasted HTML

Output

public HTTPS live URL

Agent path

MCP, CLI, or JSON output

Setup

no Git or CI/CD; build frameworks first, single HTML/Markdown/PDF is direct

Upload-first workflow

Upload frontend builds, HTML, Markdown, or PDF

For React/Vue/Vite/Next, run the build step first, then upload dist/build/out/public or a zip with index.html. Single HTML, Markdown, and PDF files still work directly.

Start with upload Upload HTML, Markdown, or PDF page

Drop dist/build/out zip, .html, .md, or .pdf

Upload browser-ready output, not a source-code project.

Upload these

React/Vue/Vite/Next static export: dist, build, out, or public zip with index.html

HTML/CSS/JS assets bundled with index.html

report.html, README.md, docs.markdown, report.pdf, or generated HTML pasted from agents

Do not upload these

Raw source zips with package.json and src/

node_modules or dependency folders

React/Vue/Next/Vite source before running the build command

Build output, HTML, Markdown, or PDF

Static deploy

Live URL

Built around the workflows users already try

AI HTML artifacts

Publish generated reports, prototypes, dashboards, and single-file pages from ChatGPT, Claude, Cursor, and coding agents.

Direct HTML, Markdown, and PDF support

Upload .html, Markdown, or .pdf directly, paste HTML, or deploy ./page.html, ./README.md, or ./report.pdf with CLI/MCP. PDF links open in a full-screen browser-native reader.

Framework build output

React, Vue, Vite, Next, Astro, and Svelte projects work after build; upload dist/build/out/public, not source folders.

Publish frontend builds, HTML, Markdown, and PDF

One product for every artifact-to-live-URL workflow

Most hosting tools optimize for one path: paste HTML, upload a zip, or run a CLI. PreviewShip covers browser-ready builds, AI-generated HTML, Markdown, full-screen PDF links, editor deploys, and MCP-enabled agents.

Paste HTML and publish

Paste a complete HTML document in the console and get a live URL for ChatGPT, Claude, Gemini, or Cursor output.

Learn more

Upload a single HTML, Markdown, or PDF file

Upload report.html, README.md, docs.markdown, report.pdf, or another standalone document. HTML and Markdown get web entry pages; PDF opens in a full-screen browser-native reader.

Learn more

Deploy React/Vue build output

Deploy Vite, React, Vue, Next static export, Astro, or Svelte output: dist, build, out, public, or a build-output zip with index.html.

Learn more

Let an AI agent deploy

Use MCP or CLI JSON output so Claude Code, Cursor, Windsurf, and Codex can finish with a shareable preview link.

Learn more

See It In Action

A sample conversation between a developer and an AI coding agent.

Agent handoffURL ready

Build me a landing page for my SaaS product with a hero section, features grid, and pricing table.

AI Agent

I'll build that for you right away. Write(landing/index.html) — 186 lines Write(landing/style.css) — 124 lines Write(landing/app.js) — 95 lines Your landing page is ready! Open landing/index.html to preview.

Looks great! Can you deploy it so I can share it with my team?

AI Agent

I'll deploy it to PreviewShip and get you a shareable link.

$ previewship deploy ./landing --json

It's live! Share this link with your team: https://my-saas.previewship.net The link is publicly accessible — anyone can view it.

From idea to shareable URL — without leaving the conversation.

Everything you need for instant previews

Deploy React/Vue/Vite/Next build output, generated HTML, Markdown, PDF documents, and frontend artifacts from anywhere — console, editor, terminal, or AI agent. No complex setup required.

Instant Previews

Upload dist/build/out/public output and get a live preview URL in seconds. No CI/CD configuration needed.

AI HTML Ready

Publish generated HTML reports, Markdown notes, dashboards, landing pages, and prototypes as public preview links.

AI Agent Ready

Built for AI coding agents like Claude Code, Cursor, Windsurf, Codex, and OpenClaw. Deploy via MCP or CLI.

Codex Chat Sharing

Install the optional share-codex-chat skill to publish a Codex conversation as a high-fidelity PreviewShip link.

Claude Code Chat Sharing

Install the optional share-claude-code-chat skill to publish a Claude Code conversation with readable tool timelines and safe hidden-reasoning handling.

CLI Deploy

Deploy dist/build/out or a single HTML, Markdown, or PDF file from the terminal with one command. Perfect for scripts, CI pipelines, and AI agents.

MCP Native

First-class MCP server support. Any MCP-compatible agent can deploy previews as a tool call.

Manual Upload

Drag & drop a build-output zip, upload a single HTML/Markdown/PDF file, or paste HTML in the console. No plugins required — works from any browser.

Share Anywhere

Get a unique preview link to share with teammates, clients, or stakeholders instantly.

Built for the pages AI tools actually generate

PreviewShip is strongest when the output is already browser-ready and the next step is sharing it with someone else.

AI-generated HTML reports

Publish dashboards, analysis reports, calculators, and data visualizations as reviewable browser links.

Claude and ChatGPT artifacts

Turn single-file artifacts into public URLs without sending raw HTML files or screenshots.

Frontend review previews

Share work-in-progress UI with teammates, clients, QA, or design reviewers without creating a staging pipeline.

Agentic frontend workflows

Let agents build, package, deploy, and return a URL in the same conversation or automation run.

Built for AI Agents

Deploy previews directly from your AI coding agent. Two integration methods — choose what fits your workflow.

CLI

# Install (or use npx directly)
npm install -g previewship

# Set your API Key
previewship login

# Deploy
previewship deploy ./dist
previewship deploy ./report.html

# JSON output for agents
previewship deploy ./dist --json
previewship deploy ./report.html --json

CLI

One-command deploy from any terminal or AI agent. Structured JSON output for automation.

One-Call Deploy

Single command or tool call creates a live site.

Zero Config

No manifests or project files. Just point and deploy.

Structured Output

JSON responses for easy parsing by agents.

Global CDN

Sites served on a worldwide edge network.

Optional agent chat skills

Share AI coding conversations when the work itself needs context.

For Codex and Claude Code users, PreviewShip skills can turn visible chat history into polished HTML pages and publish them as public URLs for debugging notes, implementation records, and review handoff.

Not required for normal deploysHigh-fidelity chat transcriptsUseful for review context

Read Claude Code skill docs

Share Codex chat

Export the visible Codex transcript as a high-fidelity PreviewShip page.

Codex docs

Install skill

npx skills add blockdancez/PreviewShip --skill share-codex-chat -a codex -g --yes

Use in Codex

$share-codex-chat 分享当前 Codex 对话

Share Claude Code chat

Render Claude Code JSONL history into a readable page, hide reasoning text, and keep tool activity in a collapsible timeline.

Claude Code docs

Install skill

npx skills add blockdancez/PreviewShip --skill share-claude-code-chat -a codex -g --yes

Use in Codex

$share-claude-code-chat 分享 Claude Code 对话

Preview hosting comparison

Faster than Git-based hosting when you only need a public preview URL

GitHub Pages, Vercel, Netlify, Surge, Tiiny Host, HTML Pub, and Aired all solve parts of static hosting. PreviewShip focuses on the narrow workflow AI builders keep repeating: generated HTML or build output in, shareable preview URL out.

vs HTML Pub Tiiny Host Alternative vs Surge vs Aired

Workflow	PreviewShip	General static hosts
Single HTML/Markdown/PDF	Paste HTML, upload .html/.md/.markdown/.pdf, or deploy ./page.html and ./README.md from CLI/MCP/editor.	Often requires a repo, file manager, subdomain setup, or a zip with index.html.
AI agents	MCP server, CLI, and structured JSON output are first-class paths.	Usually optimized for human dashboards or Git push workflows.
Frontend builds	Upload ready-to-serve dist/build/out/public output or zip.	Often tied to Git, build settings, or broader production hosting.
Review links	Designed for temporary previews, design review, QA, and client approval.	Usually broader website hosting, production deploys, or personal pages.

How It Works

Three simple steps to share your frontend preview.

Upload

Upload a built static artifact from React/Vue/Vite/Next, or publish a single HTML/Markdown/PDF file directly via console, VS Code/Cursor, CLI, or MCP agents.

Deploy

We deploy your project to a global CDN and generate a unique preview URL.

Share the preview link with your team. They can view it instantly in any browser.

Editor Extensions

Deploy from VS Code or Cursor with a single command.

Cursor

Cursor is fully compatible with VS Code extensions. Same installation steps.

1
Open Cursor, press Ctrl+P (Cmd+P on Mac), paste the command below and press Enter:
ext install previewship.previewship
2
Run "PreviewShip: Set API Key" from the command palette (Ctrl+Shift+P) and enter your API Key.
3
Open your project folder, run "PreviewShip: Deploy Workspace, HTML, Markdown, or PDF File", or open a .html/.md/.pdf file and run "PreviewShip: Deploy Active HTML, Markdown, or PDF File" — get a preview link in seconds.

VS Code

Install from the VS Code Marketplace or use the command palette.

1
Open VS Code, press Ctrl+P (Cmd+P on Mac), paste the command below and press Enter:
ext install previewship.previewship
2
Run "PreviewShip: Set API Key" from the command palette (Ctrl+Shift+P) and enter your API Key.
3
Open your project folder, run "PreviewShip: Deploy Workspace, HTML, Markdown, or PDF File", or open a .html/.md/.pdf file and run "PreviewShip: Deploy Active HTML, Markdown, or PDF File" — get a preview link in seconds.

Don't have an API Key yet? Register for free, go to the API Keys page in the console to create one.

Download VSIX

For offline or manual installation in Cursor / VS Code

Simple, transparent pricing

Start free, upgrade when you need password access, longer retention, more rollback history, or higher deploy limits. Launch discount is applied automatically at checkout.

Free

$0 forever

1 project slot (delete unused projects to free it)
5 deploys / day
15 MB max zip
3 day preview expiry
3 recent rollback versions
PreviewShip watermark

Get Started

Pro Monthly

$8.10 /mo

10% off auto-applied

20 projects
50 deploys / day
50 MB max zip
Continuous hosting while subscribed
Rolling 1-month hosting guarantee
Password access for fixed links
10 rollback versions
No PreviewShip watermark

Pro Yearly

$84

$75.60 /yr ($6.30/mo)

10% off auto-applied

40 projects
80 deploys / day
80 MB max zip
Continuous hosting while subscribed
Rolling 12-month hosting guarantee
About 22% standard savings
Password access for fixed links
40 rollback versions
No PreviewShip watermark

Frequently Asked Questions

Common questions about PreviewShip.