I've been using coding agents to write in markdown, make slides, and build interactive data analysis as static HTML files. Sending those files around still gets messy fast: you can't update them after sharing, and there's no way to get feedback inline. This is the reason I built sharehtml.
Deploy a local document, get a link where others can view it and collaborate with comments, reactions, and live presence. Re-deploy to update the content at the same URL. Markdown and common code files are converted to styled HTML automatically.
- CLI deploys —
sharehtml deploy report.html→https://sharehtml.yourteam.workers.dev/d/9brkzbe67ntm - Collaborative — comments, threaded replies, emoji reactions, text anchoring
- Live presence — see who's viewing and their selections
- Home page — your documents and recently viewed docs shared with you
- Self-hosted — runs on your own Cloudflare account
- Node.js 18+ and pnpm
- Bun (for the CLI and setup script)
- Cloudflare account with R2 enabled (free tier available)
git clone https://github.com/jonesphillip/sharehtml.git
cd sharehtml
pnpm install
npx wrangler login
pnpm run setupThe interactive setup script walks you through everything: deploying the worker, installing the CLI, and configuring authentication. Cloudflare Access is optional — the setup script asks if you want authentication. Without it, anyone with a link can view and comment.
To install the CLI directly:
# with Bun
bun install -g sharehtml
# or with npm (Bun still needs to be installed for the CLI runtime)
npm install -g sharehtmlIf your team already has a sharehtml worker deployed, this is probably all you need — install the CLI, run sharehtml config set-url <your-team-url>, then sharehtml login.
If you enable Cloudflare Access, you'll need a Cloudflare API token with these permissions:
- Account > Access: Apps and Policies > Edit
- Account > Access: Organization, Identity Providers, and Groups > Read
When it's done, try deploying one of the included examples:
sharehtml deploy example/coffee-report.html
# or try the markdown example:
sharehtml deploy example/sample.md
# or the interactive slideshow example:
sharehtml deploy example/nba-slideshow.html
# or deploy a code file:
sharehtml deploy apps/cli/src/index.tsIf a document with the same filename exists, the CLI will prompt to update it. Use -u to skip the prompt.
If you've already run setup and just need to redeploy:
# Deploy the worker to Cloudflare
pnpm run deploy
# Build and link the CLI globally
cd apps/cli && pnpm build && bun linkpnpm devStarts the Vite dev server with Wrangler at http://localhost:5173. In dev mode, AUTH_MODE is "none" — no login required.
To use the CLI locally:
sharehtml config set-url http://localhost:5173
sharehtml deploy my-report.htmlCLI ──► Worker ──► R2 (HTML storage)
│
Browser ◄┘──► Durable Objects
├── RegistryDO (users, documents, views)
└── DocumentDO (per-doc comments, reactions, presence via WebSocket)
| Component | Purpose |
|---|---|
| Worker | HTTP routing, auth, serves viewer shell and home page |
| RegistryDO | Global Durable Object — users, document metadata, view history (SQLite) |
| DocumentDO | Per-document Durable Object — comments, reactions, real-time presence over WebSocket |
| R2 | Stores the actual HTML files |
| CLI | Bun-based command-line tool for deploying and managing documents |
| Command | Description |
|---|---|
sharehtml deploy <file> |
Deploy an HTML, Markdown, or code file (creates or updates) |
sharehtml list |
List your documents |
sharehtml open <id> |
Open a document in the browser |
sharehtml pull <id> |
Download a document locally |
sharehtml delete <id> |
Delete a document |
sharehtml share <document> |
Make a document shareable |
sharehtml unshare <document> |
Make a document private |
sharehtml login |
Log in through Cloudflare Access |
sharehtml config set-url <url> |
Set the sharehtml URL |
sharehtml config show |
Show current configuration |
| Secret | Required | Description |
|---|---|---|
AUTH_MODE |
No | "none" disables auth, "access" enables Cloudflare Access JWT verification. Defaults to no auth if unset. The setup script sets this for you. |
ACCESS_AUD |
When AUTH_MODE=access |
Cloudflare Access Application Audience tag |
ACCESS_TEAM |
When AUTH_MODE=access |
Cloudflare Access team name |
apps/
├── worker/
│ ├── src/
│ │ ├── index.ts # Hono app, routing
│ │ ├── routes/
│ │ │ ├── api.ts # REST API (CRUD documents)
│ │ │ ├── viewer.ts # Document viewer + WebSocket proxy
│ │ ├── durable-objects/
│ │ │ ├── registry.ts # RegistryDO — users, docs, views
│ │ │ └── document.ts # DocumentDO — comments, reactions, presence
│ │ ├── frontend/
│ │ │ ├── home.tsx # Home page (document list)
│ │ │ ├── shell.tsx # Document viewer shell
│ │ ├── client/
│ │ │ ├── shell-client.ts # Viewer shell JS (presence, sidebar)
│ │ │ ├── collab-client.ts # In-iframe collaboration (comments, reactions)
│ │ │ └── styles.css # Shared styles
│ │ └── utils/
│ │ ├── auth.ts # CF Access JWT verification
│ │ ├── registry.ts # getRegistry() helper
│ │ ├── crypto.ts # sha256 utility
│ │ ├── assets.ts # Vite asset URL resolution
│ │ └── ids.ts # nanoid generator
│ ├── scripts/
│ │ └── setup.ts # Interactive production setup script
│ └── wrangler.jsonc # Cloudflare Workers config
├── cli/
│ └── src/
│ ├── index.ts # CLI entry point (commander)
│ ├── commands/ # deploy, list, open, delete, config
│ ├── api/ # HTTP client for worker API
│ └── config/ # Local config store (~/.config/sharehtml)
└── packages/
└── shared/ # Shared types (messages, comments, reactions)
Apache-2.0