preview.forgefx.dev

An internal, zero-infra way to turn a standalone HTML file into a durable, shareable link. Built from the fast-preview-race benchmark that pitted nine publish methods against each other.

Two publish modes

• Fast (default) — uploads the file as a GitHub gist served through githack. A real page live in ~2 seconds, no deploy. The URL is durable but machine-shaped.
• Clean (--clean <name>) — deploys to the Cloudflare Pages project preview, landing at preview.forgefx.dev/<name>. Branded and tidy; a real deploy, so slightly slower.

How clean mode stays durable

• Cloudflare Pages serves a whole directory and every deploy is a full snapshot, so one local host dir accumulates every shared page and the entire dir is redeployed each time — previously-shared links survive.
• This homepage (index.html) is regenerated on every clean publish: it relists all shared pages, newest first, and pins the /hello example, so nothing gets lost and the page is never blank.

Verification

Each publish polls the live URL until it returns 200 + text/html with the page's own content as a marker — a link is only reported live once it genuinely renders in a browser.

Under the hood

• Skill: .claude/skills/devops/subskills/preview-share/share-preview.ts (invoked as /share-preview).
• Fast mode needs gh (authenticated); clean mode reads Cloudflare creds from Doppler (appworks/prd) and deploys via wrangler pages deploy.
• Manage shared pages: --list to see recent gists, --rm <id> to delete one.