Atlas Docs on Astro Starlight

The Atlas docs — WP Engine’s headless WordPress hosting product — lived as ~100 MDX files in one GitHub repo, ingested by a Next.js shell in another. Editing the content didn’t trigger a rebuild or a preview, so every change went through a dedicated environment and a round of branch management. Visual changes took sprints. And because the whole thing bottomed out in React, only developers could contribute: the PMs and support folks who knew the product best couldn’t touch the page that described it.

Starlight had launched on Product Hunt in August 2023 with the entire repeatable surface already built — navigation, search, i18n, syntax highlighting, dark mode, logo theming. The migration was to copy the existing MDX folder into the Starlight template, at which point there was a live site. What was left was a config file and a stylesheet.

The numbers Astro published afterward: development costs down more than 50%, content operations more than twice as fast, and a time split that went from roughly 30:70 content-to-maintenance to 95:5. The dependency surface collapsed from a pile of individually-versioned UI components to one framework, which took the open Dependabot queue to zero.

The part that mattered most isn’t in the numbers. Shipping only HTML meant a contributor no longer had to know JavaScript or React to fix a docs page, so the people with the most product context stopped needing a developer as an intermediary.