Expand the EmDash CMS guide from stub to full guide

[danielmlr]

Description (required)

This replaces the EmDash stub with a full CMS guide, structured like the Keystatic guide, the other CMS that runs inside the Astro project.

It opens with how EmDash integrates with Astro, then covers installing the packages, the integration, the live collections loader, the setup wizard, creating a post, rendering content with getEmDashCollection() and getEmDashEntry(), and deploying; the stub's official resources stay. React is added with astro add react, as in the Keystatic guide, which brings the JSX compiler options and type packages.

Every step and code block was run against fresh Astro projects (Astro 7.2.10, emdash 0.36.0, Node 26). Two choices come from that rather than the EmDash docs: output: "server" is a prerequisite because a static build fails while prerendering an EmDash API route, and the single-entry example omits the error branch, since getEmDashEntry() sets error for an unknown slug too, which turns the docs' error-then-404 pattern into a 500 on every unknown URL.

References

• Related to Add EmDash CMS guide stub #14395

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/guides/cms/emdash.mdx	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[github-actions]

Preview deployment

✅ Deployment complete!

• Latest commit: 0b2f427
• Preview: https://add-emdash-cms-guide.previews.docs.astro.build
• Workflow run: View logs

[ArmandPhilippot]

Thank you for the guide, and your patience!

I left a few suggestions around content organization and components use based on our contributing guide. Feel free to check the accuracy and reword if needed where I suggested some content changes.

[danielmlr]

Thanks for the review. I applied all of it, including the new "Integrating with Astro" section and the setup-wizard reorder with npm run dev as the first step. Your Cloudflare link had a doubled opening paren, which I fixed on the way in.

On output: "server": you are right, and it is a requirement, not a convention. With output: "static" and the Node adapter, astro build fails while prerendering, on an EmDash API route rather than on anything the reader wrote:

prerendering static routes
[GetStaticPathsRequired] `getStaticPaths()` function is required for dynamic routes. Make sure that you `export` a `getStaticPaths()` function from your dynamic route.
  Location:
    …/emdash/dist/astro/routes/api/admin/allowed-domains/_domain_.mjs:0:0

export const prerender = false on the reader's own pages does not change that. Measured on EmDash 0.36.0 with Astro 7.2.10.

On React: the manual install is gone. The guide now uses astro add react and installs emdash separately, the way the Keystatic guide handles the same case, so the JSX compiler options and the React type packages come along and there is no TypeScript step to skip.

[ArmandPhilippot]

Thanks for the updates! This looks almost good to me.
I've left two suggestions for the "Installing dependencies" section. I can see this is the same format used in the Keystatic guide but this is an old guide, and I think this can be improved to match our current writing style.

[ArmandPhilippot]

If the guide is about adding EmDash to an existing project, installing React might not be necessary for everyone. So, I think this should be phrased differently:

Suggested change

	Add the React integration (for the EmDash admin UI) to your Astro project, using the `astro add` command for your package manager. It is required even if your site does not otherwise use React:
	React powers the EmDash admin interface and is a required dependency. If your project does not use React, install it using the `astro add` command for your package manager:

[danielmlr]

Applied. Your version is more accurate too: a project that already has the React integration has nothing to do at this step.

[ArmandPhilippot]

nit: I can see the Keystatic guide use the future tense, but this is an old guide that may not be fully updated to conform to our current standards. We usually address to the reader using the present tense:

Suggested change

	You will also need the EmDash package:
	You also need to install the EmDash package:

[danielmlr]

Applied.

[danielmlr]

Both applied in a997a32. I also changed one more future-tense line for the same reason, in "Running EmDash locally": "You will be redirected to the setup wizard" is now "EmDash redirects you to the setup wizard". Revert that one if you'd rather keep the diff to what you flagged.

[ArmandPhilippot]

Thanks again for the updates, and this new guide! 🙌🏽