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.
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.jsonagainst 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
- Unzip the downloaded file (it contains a
emdash-cloudflare-deploy/folder withSKILL.md). - Copy the whole folder into your agent's skills folder.
- Claude Code:
~/.claude/skills/(per project:.claude/skills/) - Hermes Agent:
~/.hermes/skills/
- Claude Code:
- Restart the agent and check that the skill appears in its skill list.