Claude Code makes HTML artifacts worth reading. Handoff makes them worth sharing.

Claude Code can produce more than code. It can turn a messy problem into a readable HTML spec, a visual implementation plan, a PR explainer, a data report, a prototype, or a small custom editor built for one decision.

That is the point where Markdown starts to feel small. HTML gives the artifact structure, color, diagrams, tables, interactions, and visual hierarchy. Handoff gives that artifact a URL. See HTML artifact examples for Claude Code for the kinds of artifacts worth sharing.

If Claude Code saved code_artifact.html, open that file in a browser, or upload it to Handoff and share the link.

Working in the Claude desktop or web app rather than the terminal? See how to share a Claude Artifact as a public link.

Share your first artifactFree plan, no credit card needed

Need unlimited files or password protection? Get Pro for $5/mo.

The new AI artifact is not a Markdown file

Markdown is still useful for notes and docs. But when Claude Code is explaining a system, comparing designs, reviewing a pull request, or building an interactive planning surface, HTML is often the better output.

HTML can carry the shape of the idea:

Information density with tables, callouts, sidebars, and compact sections.
Visual clarity with diagrams, color, cards, and responsive layouts.
Interaction with filters, sliders, tabs, checklists, and copy buttons.
Context from the file system, git history, browser, and connected tools.
Readable sharing for teammates who will not open a 400-line Markdown file.

The artifact gets better. The sharing workflow often does not.

Claude Code writes local files. Teams need links.

Claude Code can generate implementation-plan.html in your repo. That is great while you are working locally. It is awkward when you want someone else to review it.

Without Handoff, the next step is usually one of these:

Send the raw .html file and hope the recipient knows what to do.
Screenshot it and lose the interactions.
Push it to GitHub Pages, Netlify, Vercel, or S3.
Copy pieces into Slack, Notion, or a PR description and lose the artifact itself.
Keep asking, "which version are we reviewing?"

Handoff closes that last mile. Sign up with email or Google, upload the file, and send a URL anyone can open. Viewers do not need an account.

From Claude Code, paste the setup prompt from the dashboard modal. That adds the Handoff skill. Claude Code then uploads with curl and the HANDOFF_API_TOKEN environment variable. The same request, written out:

curl -X POST https://handoff.host/api/upload/ \
  -H "Authorization: Bearer $HANDOFF_API_TOKEN" \
  -F "[email protected]" \
  -F "slug=spec-review"

The token is created at signup. Copy it from Dashboard > Settings > API token.

You can also upload in the browser on the dashboard. The slug is optional. Leave it blank and Handoff uses the filename. A slug is 3-50 lowercase letters, numbers, or hyphens. Uploading the same slug again publishes a new version:

handoff.host/@yourname/spec-review/

What to share

Specs and implementation plans

Ask Claude Code to produce a plan as HTML with mockups, data flow diagrams, risk tables, and code snippets. Upload it, send the link, and upload the same slug again as the plan evolves. The URL stays the same.

PR and code review explainers

Use HTML to explain a diff with annotated snippets, severity labels, module diagrams, and reviewer notes. Add the Handoff link to the pull request so reviewers see the story behind the changes.

Design explorations and prototypes

Generate multiple UI directions in one grid, prototype a tiny interaction, or create a comparison board for stakeholders. Handoff turns the local prototype into a link that works on desktop and mobile.

Reports and research

Claude Code can synthesize files, data, git history, and external context into a readable HTML report. Handoff makes that report easy to send to a team, client, or leadership group.

Custom editing interfaces

Sometimes a text prompt is the wrong interface. Claude Code can make a one-off HTML editor for feature flags, prompt tuning, ticket prioritization, config review, or dataset curation. Handoff gives that editor a shareable surface.

Why versioning matters for AI artifacts

AI artifacts are iterative by nature. You ask for a draft, review it, ask for changes, add context, and refine again. If every iteration produces a new file or a new deployment, your collaborators end up with stale links.

Upload the same slug again and Handoff publishes a new version. Pages do not expire.

handoff.host/@you/spec-review/        -> latest
handoff.host/@you/spec-review/v/1/    -> first draft
handoff.host/@you/spec-review/v/2/    -> revised version

The main URL always shows the latest version. Older versions remain available when someone needs to reference exactly what they saw.

Built for the Claude Code loop

Ask Claude Code to generate an HTML artifact.
Review it locally.
Ask Claude Code to revise it.
Upload it with the Handoff skill, from the dashboard, or with the API.
Share the URL in Slack, a PR, a doc, or a client thread.
Upload the same slug again as the artifact improves.

You do not need a deployment project for every artifact. You need a fast bridge from "file on disk" to "URL in the conversation."

Start with this prompt

Create a polished HTML artifact for this plan. Use visual hierarchy, tables, diagrams, and annotated code snippets where useful. Make it self-contained so I can upload it to Handoff and share the link.

Then paste the Handoff skill setup prompt from the dashboard modal and ask Claude Code to upload the file. Or send it yourself:

curl -X POST https://handoff.host/api/upload/ \
  -H "Authorization: Bearer $HANDOFF_API_TOKEN" \
  -F "[email protected]" \
  -F "slug=artifact"

Get Pro for $5/mo or start free. Pro is unlimited files, 10 MB pages, 20 MB images, password protection, and no Handoff bar. Free is 5 files, 2 MB pages, 5 MB images, and a Handoff bar.