Skip to content

[Workers] Add EmDash framework guide - #34937

Open
kale-stew wants to merge 1 commit into
productionfrom
kylie/docs/emdash-framework-guide
Open

kale-stew wants to merge 1 commit into
productionfrom
kylie/docs/emdash-framework-guide

Conversation

@kale-stew

@kale-stew kale-stew commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

Summary

Adds a Workers framework guide for EmDash, the open-source CMS built on Astro (source). EmDash has no page on developers.cloudflare.com today, so people searching the docs for a CMS on Workers find nothing.

The guide is short and links out to the EmDash docs for depth:

  • Scaffold with npm create emdash@latest (Cloudflare Workers target)
  • A table of the Cloudflare products EmDash uses (D1, R2, Cron Triggers, KV, Images, Static Assets, Dynamic Workers), with binding names and where each one is configured
  • Preview and deploy, plus setup cautions (first admin, passkey hostname) and the encryption key secret
  • Turning on sandboxed plugins (Workers Paid)
  • The agent files and MCP server each template ships

It sits directly under Astro in the sidebar. astro.mdx gets a one-line pointer to it.

Verified against create-emdash 1.4.0 and the starter-cloudflare template: scaffold, build, wrangler dev, and a real first wrangler deploy, which provisioned the D1 database, R2 bucket, and SESSION KV namespace. The config example follows the template, not the EmDash deploy guide, where the two differ.

The nodejs_compat guidance matches #34864: the example uses $today without the flag and explains why the template still sets it. This PR adds no merge conflicts to #34864.

Screenshots (optional)

emdash-products emdash-top

Documentation checklist

  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@github-actions github-actions Bot added the product:workers Related to Workers product label Nov 5, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed a223649 · 0 findings · incremental

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Review coverage

✅ The ownership area is covered.

✅ 1 area already covered
Area Approved by
workers
2 files changed
irvinebroque
CODEOWNERS mappings for displayed areas (1)
Pattern Owners
/src/content/docs/workers/ @GregBrimble, @irvinebroque, @korinne, @MattieTK, @mikenomitch, @vy-ton, @WalshyDev, @cloudflare/deploy-config, @cloudflare/dev-plat-leads, @cloudflare/workers-runtime-1, @cloudflare/wrangler, @cloudflare/product-owners

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://kylie-docs-emdash-framework-guide.previews.developers.cloudflare.com (commit a223649)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://501edf9c.previews.developers.cloudflare.com a223649 2026-11-05T03:17:03.436Z Visit the dashboard ↗

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants