hemx/examples/cloudflare_do/README.md

hemx on Cloudflare Durable Objects

This proof keeps the hemx authoring and wire model intact while Cloudflare owns room placement, persistence, and hibernating WebSockets:

room.heml -> hemx-build generated resources -> Rust RoomState
          -> generated counter partial -> canonical EffectBatch bytes
          -> Durable Object hibernating sockets -> hemx browser runtime

The Durable Object stores only the counter. It never stores HTML, DOM patches, or EffectBatch values as domain truth.

Local commands

cargo test -p hemx-cloudflare-do-example
cargo check --target wasm32-unknown-unknown -p hemx-cloudflare-do-example
cd examples/cloudflare_do
npx wrangler dev

Open the printed local URL in two tabs. Incrementing in either tab should update both without reload. Stop and restart wrangler dev; the room counter should remain.

A hosted deployment requires an authorized Cloudflare account. Production auth, CSRF, tenancy, jurisdiction, reconnect replay, and deployment policy are deliberately outside this proof.