Portable HTML mini-apps. One file. Email it.

The CLI compiles your project tree into a single self-contained .html — runtime, code, and source bundled inside. The artifact runs in any browser. Recipients can unbundle it back to source and iterate.

npm install -g @work.books/cli

Then workbook init my-thing && cd my-thing && workbook build. Out comes dist/my-thing.html — runs anywhere a browser runs.

Use with Claude Code

Install the Workbooks skill so Claude Code knows how to scaffold, lint, and ship workbooks — file format, runtime API, build pipeline, and deploy guidance all on hand.

curl -fsSL https://workbooks.sh/skill | sh

How it works

workbook build compiles your project — Svelte, React, vanilla, whatever — into a single .html. Three things land inside:

Runtime + your code. Single JS chunk, no CDN, no fetch on open. Wasm runtimes (Polars, Plotters, Rhai, Candle) ship inline when you opt in.
Source bundle. Gzipped JSON snapshot of your tree (default on). Recipients run workbook unbundle <file.html> and get a working source directory back. Browsers ignore the embed entirely — zero runtime cost.
Optional author claim. Ed25519 signature over the artifact bytes; recipients verify it came from you and hasn't been altered.

The .html is the only thing that ships. Email it, drop it on a USB stick, attach it to a ticket. It opens anywhere a browser runs.

When you need persistence

Bare .html artifacts are stateless — perfect for one-shot deliverables (a chart, a presentation, a calculator, a tool). When recipients need state to survive a session — a binder shared between teammates, a notebook many people co-edit — share via the hosted viewer at workbooks.sh. The artifact stays portable; the hosted view adds login, storage, and per-user state.

You don't have to host a workbook to share it. Hosting is the path when recipients need to keep their own state across sessions.

What it doesn't do

Phone home. The compiled .html never makes a network call you didn't write.
Need a server. Bare HTML — open with file://, or serve from any static host.
Replace your editor. Workbooks are HTML — author them in any tool you like.