# htmlshare

> htmlshare hosts a single self-contained HTML file at a clean, fast, sandboxed URL so you can share it with anyone — no installs, no sign-ups for the people you send it to. It is built for the HTML that AI agents (ChatGPT, Claude, Gemini, and others) now generate: dashboards, reports, slide decks, charts, mockups, and mini-apps that live in one `.html` file.

## What problem it solves

People increasingly ask an AI to "build me an HTML page/report/dashboard" and get back a single self-contained file. That file is hard to share: email clients won't render it, chat apps download it as an attachment, and the recipient often can't open it. htmlshare turns that file into a live link in seconds — the page renders fully (JavaScript runs, CDN styles load, charts animate) for anyone who opens it.

## How to use it

- **Web**: sign in with a magic link at https://www.htmlshare.ca/app, upload or paste an HTML file, and copy the shareable URL.
- **CLI**: `npm i -g @automintech/htmlshare`, then `htmlshare deploy report.html --title "Q4 report"` prints a view URL and a download URL. `htmlshare fetch <slug>` reads one back; `htmlshare list "<query>"` finds one.
- **AI agents (MCP)**: the same npm package ships an MCP server (`htmlshare-mcp`). Point Claude Desktop, Claude Code, or Cursor at it and the agent gets `htmlshare_deploy`, `htmlshare_fetch`, and `htmlshare_list` as native tools — it can publish the HTML it just generated without any copy-paste.

## Key facts

- Free to use. No passwords (magic-link sign-in). No account needed to *view* a shared link.
- Shared HTML is served from a separate, hardened **view domain** (`view.htmlshare.ca`) with no cookies and a Content-Security-Policy that blocks every outbound network call — your auth context can never leak into untrusted content.
- Every artifact gets a short, random, non-enumerable slug, so old links keep working.
- Each link also has a `?download=1` form that returns the raw `.html` file.

## Links

- [App / sign in](https://www.htmlshare.ca/app)
- [npm package (@automintech/htmlshare)](https://www.npmjs.com/package/@automintech/htmlshare)
- [Full profile for AI agents](https://www.htmlshare.ca/llms-full.txt)