[{"data":1,"prerenderedAt":107},["ShallowReactive",2],{"hub:tools-starlight":3},{"path":4,"key":5,"title":6,"h1":7,"description":8,"crumbs":9,"blocks":17},"\u002Ftools\u002Fstarlight\u002F","tools-starlight","Starlight Documentation Framework Guides","Starlight","Guides for docs sites on Starlight: customizing without forking, translation, build times against Docusaurus and VitePress, and migrating in.",[10,13,16],[11,12],"Home","\u002F",[14,15],"Tools","\u002Ftools\u002F",[7,4],[18,21,23,26,73,75,77],{"k":19,"text":20},"p","Starlight is the documentation framework built on Astro: sidebars, search with Pagefind, translated interface strings and accessible defaults, with almost no JavaScript per page. The guides below cover running it in production — overriding components instead of forking the theme, adding languages, and how its build times and page weight compare with Docusaurus and VitePress on the same 2,000-page corpus.",{"k":19,"text":22},"Two of them are migrations into Starlight, from MkDocs and from Docusaurus, with the conversion scripts, redirect maps and measured results.",{"k":24,"html":25},"fig","\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 152\" role=\"img\" aria-labelledby=\"hub-starlight-hero-title hub-starlight-hero-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-starlight-hero-title\">Steps covered by the Starlight guides\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-starlight-hero-desc\">Four steps. Compare frameworks on build time and page weight. Migrate content from MkDocs or Docusaurus. Customize with component overrides rather than a fork. Add languages with locales and translated sidebars.\u003C\u002Fdesc>\n  \u003Crect x=\"0\" y=\"0\" width=\"760\" height=\"152\" fill=\"#ffffff\"\u002F>\n  \u003Cg style=\"font-family:system-ui, sans-serif;font-size:12px\">\n    \u003Crect x=\"20.0\" y=\"64.0\" width=\"154.5\" height=\"71.5\" rx=\"8\" fill=\"#ffca3a\" opacity=\"0.24\" stroke=\"#a97b00\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Crect x=\"208.5\" y=\"64.0\" width=\"154.5\" height=\"71.5\" rx=\"8\" fill=\"#6a4c93\" opacity=\"0.14\" stroke=\"#6a4c93\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Cpath d=\"M176.5 99.8 L204.5 99.8\" fill=\"none\" stroke=\"#556071\" style=\"stroke-width:2px;marker-end:url(#hub-starlight-hero-arrow)\"\u002F>\n    \u003Crect x=\"397.0\" y=\"64.0\" width=\"154.5\" height=\"71.5\" rx=\"8\" fill=\"#1982c4\" opacity=\"0.14\" stroke=\"#1982c4\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Cpath d=\"M365.0 99.8 L393.0 99.8\" fill=\"none\" stroke=\"#556071\" style=\"stroke-width:2px;marker-end:url(#hub-starlight-hero-arrow)\"\u002F>\n    \u003Crect x=\"585.5\" y=\"64.0\" width=\"154.5\" height=\"71.5\" rx=\"8\" fill=\"#8ac926\" opacity=\"0.2\" stroke=\"#5a8a16\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Cpath d=\"M553.5 99.8 L581.5 99.8\" fill=\"none\" stroke=\"#556071\" style=\"stroke-width:2px;marker-end:url(#hub-starlight-hero-arrow)\"\u002F>\n    \u003Ctext x=\"380.0\" y=\"30.0\" fill=\"#1f2937\" style=\"font-size:16px;text-anchor:middle;font-weight:700\">Adopting Starlight\u003C\u002Ftext>\n    \u003Ctext x=\"97.2\" y=\"90.4\" fill=\"#1f2937\" style=\"font-size:13px;text-anchor:middle;font-weight:700\">Compare\u003C\u002Ftext>\n    \u003Ctext x=\"97.2\" y=\"107.3\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">vs Docusaurus,\u003C\u002Ftext>\n    \u003Ctext x=\"97.2\" y=\"121.6\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">VitePress\u003C\u002Ftext>\n    \u003Ctext x=\"285.8\" y=\"90.4\" fill=\"#1f2937\" style=\"font-size:13px;text-anchor:middle;font-weight:700\">Migrate\u003C\u002Ftext>\n    \u003Ctext x=\"285.8\" y=\"107.3\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">from MkDocs or\u003C\u002Ftext>\n    \u003Ctext x=\"285.8\" y=\"121.6\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">Docusaurus\u003C\u002Ftext>\n    \u003Ctext x=\"474.2\" y=\"97.5\" fill=\"#1f2937\" style=\"font-size:13px;text-anchor:middle;font-weight:700\">Customize\u003C\u002Ftext>\n    \u003Ctext x=\"474.2\" y=\"114.4\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">overrides, not forks\u003C\u002Ftext>\n    \u003Ctext x=\"662.8\" y=\"97.5\" fill=\"#1f2937\" style=\"font-size:13px;text-anchor:middle;font-weight:700\">Translate\u003C\u002Ftext>\n    \u003Ctext x=\"662.8\" y=\"114.4\" fill=\"#556071\" style=\"font-size:11px;text-anchor:middle\">locales and sidebars\u003C\u002Ftext>\n  \u003C\u002Fg>\n  \u003Cdefs>\n    \u003Cmarker id=\"hub-starlight-hero-arrow\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"7\" markerHeight=\"7\" orient=\"auto-start-reverse\">\n      \u003Cpath d=\"M0 0 L10 5 L0 10 z\" fill=\"#556071\"\u002F>\n    \u003C\u002Fmarker>\n  \u003C\u002Fdefs>\n\u003C\u002Fsvg>\n\u003Cfigcaption>Most teams arrive at the second step from one of the two migrations covered here.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>",{"k":27,"h":28,"items":29},"group","Choosing the Right Static Site Generator for Production",[30,35,39,43,47,52,57,61,65,69],{"t":31,"u":32,"d":33,"y":34},"Comparing Docs Framework Build Times","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcomparing-docs-framework-build-times\u002F","Benchmark Docusaurus, Starlight and VitePress on the same 2,000-page docs corpus: cold and warm builds, memory, output size and what drives each number.","Comparison",{"t":36,"u":37,"d":38,"y":34},"Docusaurus vs Starlight for Product Documentation","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fdocusaurus-vs-starlight-for-product-documentation\u002F","A head-to-head port of a 640-page SaaS docs site to Docusaurus and Starlight: build time, JavaScript shipped, field INP, authoring friction and upgrade cost.",{"t":40,"u":41,"d":42,"y":34},"MDX vs Markdoc for Docs Content","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content\u002F","Choose between MDX and Markdoc for documentation components: authoring errors, validation, build speed and safety for contributor-heavy docs repos.",{"t":44,"u":45,"d":46,"y":34},"VitePress vs Starlight for Vue and Astro Teams","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-vs-starlight-for-vue-and-astro-teams\u002F","VitePress and Starlight compared on the same 500-page docs set: build time, page weight, search, i18n, customisation and which team each one suits.",{"t":48,"u":49,"d":50,"y":51},"Total Cost of Ownership for Static Site Generators","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Ftotal-cost-of-ownership-for-static-site-generators\u002F","Estimate the three-year cost of running a static site on Hugo, Eleventy, Astro, Next.js export or a docs framework: people time, builds, hosting, upgrades.","Concept",{"t":53,"u":54,"d":55,"y":56},"Customizing Starlight Without Forking the Theme","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcustomizing-starlight-without-forking-the-theme\u002F","Brand a Starlight docs site with CSS custom properties, component overrides and plugins so every upgrade stays a one-line version bump instead of a merge.","How-to",{"t":58,"u":59,"d":60,"y":56},"Generating API Reference Pages in Starlight From OpenAPI","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fgenerating-api-reference-pages-in-starlight-from-openapi\u002F","Build REST API reference pages in Starlight from an OpenAPI spec at build time, link them with the guides, validate the spec in CI and keep pages fast.",{"t":62,"u":63,"d":64,"y":56},"Internationalizing Starlight Docs","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Finternationalizing-starlight-docs\u002F","Add languages to a Starlight documentation site: locales config, translated UI strings, sidebar labels, fallback notices, per-locale search and build cost.",{"t":66,"u":67,"d":68,"y":56},"Migrating from Docusaurus to Starlight","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-docusaurus-to-starlight\u002F","Move a Docusaurus documentation site to Starlight: content and admonition conversion, sidebars, MDX components, versioning decisions, redirects and results.",{"t":70,"u":71,"d":72,"y":56},"Migrating from MkDocs to Starlight","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmigrating-from-mkdocs-to-starlight\u002F","Move a Material for MkDocs site to Starlight: convert admonitions and tabs, rebuild navigation from mkdocs.yml, keep every URL and cut build time by two thirds.",{"k":24,"html":74},"\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 295\" role=\"img\" aria-labelledby=\"hub-starlight-kinds-title hub-starlight-kinds-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-starlight-kinds-title\">Number of Starlight guides of each kind\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-starlight-kinds-desc\">Vertical bars: How-tos 5, Fixes 0, Comparisons 4 and Concepts 1.\u003C\u002Fdesc>\n  \u003Crect x=\"0\" y=\"0\" width=\"760\" height=\"295\" fill=\"#ffffff\"\u002F>\n  \u003Cg style=\"font-family:system-ui, sans-serif;font-size:12px\">\n    \u003Crect x=\"80.0\" y=\"76.0\" width=\"90.0\" height=\"170.0\" rx=\"3\" fill=\"#1982c4\" opacity=\"0.3\" stroke=\"#1982c4\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"250.0\" y=\"243.0\" width=\"90.0\" height=\"3.0\" rx=\"3\" fill=\"#ff595e\" opacity=\"0.3\" stroke=\"#d83b41\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"420.0\" y=\"110.0\" width=\"90.0\" height=\"136.0\" rx=\"3\" fill=\"#ffca3a\" opacity=\"0.45\" stroke=\"#a97b00\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"590.0\" y=\"212.0\" width=\"90.0\" height=\"34.0\" rx=\"3\" fill=\"#6a4c93\" opacity=\"0.3\" stroke=\"#6a4c93\" style=\"stroke-width:1px\"\u002F>\n    \u003Cpath d=\"M30.0 246.0 L730.0 246.0\" fill=\"none\" stroke=\"#556071\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Ctext x=\"380.0\" y=\"30.0\" fill=\"#1f2937\" style=\"font-size:16px;text-anchor:middle;font-weight:700\">Starlight guides by kind\u003C\u002Ftext>\n    \u003Ctext x=\"125.0\" y=\"69.0\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">5\u003C\u002Ftext>\n    \u003Ctext x=\"125.0\" y=\"264.0\" fill=\"#556071\" style=\"font-size:11.5px;text-anchor:middle\">How-tos\u003C\u002Ftext>\n    \u003Ctext x=\"295.0\" y=\"236.0\" fill=\"#b32b30\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">0\u003C\u002Ftext>\n    \u003Ctext x=\"295.0\" y=\"264.0\" fill=\"#556071\" style=\"font-size:11.5px;text-anchor:middle\">Fixes\u003C\u002Ftext>\n    \u003Ctext x=\"465.0\" y=\"103.0\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">4\u003C\u002Ftext>\n    \u003Ctext x=\"465.0\" y=\"264.0\" fill=\"#556071\" style=\"font-size:11.5px;text-anchor:middle\">Comparisons\u003C\u002Ftext>\n    \u003Ctext x=\"635.0\" y=\"205.0\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">1\u003C\u002Ftext>\n    \u003Ctext x=\"635.0\" y=\"264.0\" fill=\"#556071\" style=\"font-size:11.5px;text-anchor:middle\">Concepts\u003C\u002Ftext>\n  \u003C\u002Fg>\n\u003C\u002Fsvg>\n\u003Cfigcaption>10 guides use Starlight in depth; each is listed below under the section it belongs to.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>",{"k":24,"html":76},"\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 176\" role=\"img\" aria-labelledby=\"hub-starlight-topics-title hub-starlight-topics-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-starlight-topics-title\">Topics with the most Starlight guides\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-starlight-topics-desc\">Horizontal bars, largest first: Docs Frameworks: Docusaurus, Starlight and VitePress 8, Migrating Between Static Site Generators 1 and SSG Framework Selection Matrix 1.\u003C\u002Fdesc>\n  \u003Crect x=\"0\" y=\"0\" width=\"760\" height=\"176\" fill=\"#ffffff\"\u002F>\n  \u003Cg style=\"font-family:system-ui, sans-serif;font-size:12px\">\n    \u003Crect x=\"350.0\" y=\"65.0\" width=\"365.6\" height=\"20.0\" rx=\"3\" fill=\"#6a4c93\" opacity=\"0.3\" stroke=\"#6a4c93\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"350.0\" y=\"99.0\" width=\"45.7\" height=\"20.0\" rx=\"3\" fill=\"#6a4c93\" opacity=\"0.3\" stroke=\"#6a4c93\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"350.0\" y=\"133.0\" width=\"45.7\" height=\"20.0\" rx=\"3\" fill=\"#6a4c93\" opacity=\"0.3\" stroke=\"#6a4c93\" style=\"stroke-width:1px\"\u002F>\n    \u003Cpath d=\"M350.0 60.0 L350.0 158.0\" fill=\"none\" stroke=\"#556071\" style=\"stroke-width:1.5px\"\u002F>\n    \u003Ctext x=\"380.0\" y=\"30.0\" fill=\"#1f2937\" style=\"font-size:16px;text-anchor:middle;font-weight:700\">Where Starlight comes up\u003C\u002Ftext>\n    \u003Ctext x=\"20.0\" y=\"79.2\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start\">Docs Frameworks: Docusaurus, Starlight…\u003C\u002Ftext>\n    \u003Ctext x=\"723.6\" y=\"79.5\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start;font-weight:700\">8\u003C\u002Ftext>\n    \u003Ctext x=\"20.0\" y=\"113.2\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start\">Migrating Between Static Site Generators\u003C\u002Ftext>\n    \u003Ctext x=\"403.7\" y=\"113.5\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start;font-weight:700\">1\u003C\u002Ftext>\n    \u003Ctext x=\"20.0\" y=\"147.2\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start\">SSG Framework Selection Matrix\u003C\u002Ftext>\n    \u003Ctext x=\"403.7\" y=\"147.5\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start;font-weight:700\">1\u003C\u002Ftext>\n  \u003C\u002Fg>\n\u003C\u002Fsvg>\n\u003Cfigcaption>Topic pages give the wider context for each group; the numbers count only guides that use this tool in depth.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>",{"k":27,"h":78,"items":79},"Often used with Starlight",[80,85,89,94,99,103],{"t":81,"u":82,"d":83,"y":84},"Astro","\u002Ftools\u002Fastro\u002F","Islands, content collections, astro:assets and deployment.","4 shared guides",{"t":86,"u":87,"d":88,"y":84},"Docusaurus","\u002Ftools\u002Fdocusaurus\u002F","Versioned docs, faster builds and migration out.",{"t":90,"u":91,"d":92,"y":93},"VitePress","\u002Ftools\u002Fvitepress\u002F","Vue-based docs, compared on build time and page weight.","2 shared guides",{"t":95,"u":96,"d":97,"y":98},"Eleventy","\u002Ftools\u002Feleventy\u002F","Incremental builds, image pipelines and the data cascade.","1 shared guides",{"t":100,"u":101,"d":102,"y":98},"Hugo","\u002Ftools\u002Fhugo\u002F","Build time at scale, image caches, modules and multilingual sites.",{"t":104,"u":105,"d":106,"y":98},"Next.js","\u002Ftools\u002Fnextjs\u002F","Static export for content sites, its limits and alternatives.",1790943190467]