Deploy and run EmDash CMS sites on Cloudflare Workers

Create, domain-attach, set up, upgrade and troubleshoot EmDash CMS sites on Cloudflare Workers with verification gates at every step.

Claude CodeHermes AgentCodex CLICursorMIT (modify, redistribute and use commercially)

What it does

A field-tested procedure for running the Astro-based EmDash CMS on Cloudflare Workers (D1, R2, KV).

  • Create a site from the official templates and deploy with wrangler deploy (D1/R2/KV auto-provisioned)
  • Validate seed/seed.json against a throwaway SQLite database
  • Attach custom domains and switch the site URL safely
  • Upgrade EmDash / Astro with before/after URL checks
  • Diagnose HTTP 503 and Cloudflare error 1102 (CPU limit exceeded)

How to use

Ask "create a new EmDash site on Cloudflare" or "why does the admin API return 1102?"; the agent follows the skill and references/.

CI=1 node node_modules/astro/bin/astro.mjs build < /dev/null
CI=1 node node_modules/wrangler/bin/wrangler.js deploy < /dev/null

Requirements

  • A Cloudflare account with Workers, D1 and R2
  • Node.js, wrangler, git (GitHub CLI recommended)

Notes

  • Passkey creation, OAuth approval, billing changes and domain purchases are always done by a human; the agent stops before them.
  • Deployment, setup and content launch are reported separately; only fetched-back results count as done.
  • Check official docs for current prices and limits.

How to install

  1. Unzip the downloaded file (it contains a emdash-cloudflare-deploy/ folder with SKILL.md).
  2. Copy the whole folder into your agent's skills folder.
    • Claude Code: ~/.claude/skills/ (per project: .claude/skills/)
    • Hermes Agent: ~/.hermes/skills/
  3. Restart the agent and check that the skill appears in its skill list.

Full guide