[{"data":1,"prerenderedAt":83},["ShallowReactive",2],{"hub:tools-docusaurus":3},{"path":4,"key":5,"title":6,"h1":7,"description":8,"crumbs":9,"blocks":17},"\u002Ftools\u002Fdocusaurus\u002F","tools-docusaurus","Docusaurus Guides: Versions, Builds, Migration","Docusaurus","Guides for docs on Docusaurus: versioned docs, build times and the Rspack faster option, comparisons with Starlight, and migrating out.",[10,13,16],[11,12],"Home","\u002F",[14,15],"Tools","\u002Ftools\u002F",[7,4],[18,21,23,26,61,63,65],{"k":19,"text":20},"p","Docusaurus is the most established React-based documentation framework, with versioning, a large plugin ecosystem and a mature set of defaults. Its trade-offs show up at scale: every page is bundled and hydrated as part of a React application, builds on large or heavily versioned sites take minutes and gigabytes of memory, and the JavaScript per page is several times that of static-first frameworks.",{"k":19,"text":22},"The guides below cover getting the most out of it — versioning strategy and the faster Rspack-based build — and, for teams whose priorities have shifted, a measured comparison with Starlight and a complete migration.",{"k":24,"html":25},"fig","\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 196\" role=\"img\" aria-labelledby=\"hub-docusaurus-hero-title hub-docusaurus-hero-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-docusaurus-hero-title\">Docusaurus cold build time with webpack and with the faster Rspack option\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-docusaurus-hero-desc\">Paired bars from the docs framework benchmark on a 2,000-page corpus. The cold build took 166 seconds with webpack and 81 seconds with the Rspack-based faster option. The warm build took 139 seconds with webpack and 58 seconds with Rspack.\u003C\u002Fdesc>\n  \u003Crect x=\"0\" y=\"0\" width=\"760\" height=\"196\" fill=\"#ffffff\"\u002F>\n  \u003Cg style=\"font-family:system-ui, sans-serif;font-size:12px\">\n    \u003Crect x=\"270.0\" y=\"50.0\" width=\"14.0\" height=\"12.0\" rx=\"2\" fill=\"#ff595e\" opacity=\"0.3\" stroke=\"#d83b41\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"371.1\" y=\"50.0\" width=\"14.0\" height=\"12.0\" rx=\"2\" fill=\"#8ac926\" opacity=\"0.4\" stroke=\"#5a8a16\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"230.0\" y=\"82.0\" width=\"460.9\" height=\"16.0\" rx=\"3\" fill=\"#ff595e\" opacity=\"0.3\" stroke=\"#d83b41\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"230.0\" y=\"102.0\" width=\"224.9\" height=\"16.0\" rx=\"3\" fill=\"#8ac926\" opacity=\"0.4\" stroke=\"#5a8a16\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"230.0\" y=\"134.0\" width=\"385.9\" height=\"16.0\" rx=\"3\" fill=\"#ff595e\" opacity=\"0.3\" stroke=\"#d83b41\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"230.0\" y=\"154.0\" width=\"161.0\" height=\"16.0\" rx=\"3\" fill=\"#8ac926\" opacity=\"0.4\" stroke=\"#5a8a16\" style=\"stroke-width:1px\"\u002F>\n    \u003Cpath d=\"M230.0 78.0 L230.0 176.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\">Docusaurus build time, default and Rspack\u003C\u002Ftext>\n    \u003Ctext x=\"290.0\" y=\"60.0\" fill=\"#556071\" style=\"font-size:12px;text-anchor:start\">webpack\u003C\u002Ftext>\n    \u003Ctext x=\"391.1\" y=\"60.0\" fill=\"#556071\" style=\"font-size:12px;text-anchor:start\">faster (Rspack)\u003C\u002Ftext>\n    \u003Ctext x=\"20.0\" y=\"105.2\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start\">Cold build\u003C\u002Ftext>\n    \u003Ctext x=\"697.9\" y=\"94.5\" fill=\"#b32b30\" style=\"font-size:11.5px;text-anchor:start;font-weight:700\">166 s\u003C\u002Ftext>\n    \u003Ctext x=\"461.9\" y=\"114.5\" fill=\"#3f6410\" style=\"font-size:11.5px;text-anchor:start;font-weight:700\">81 s\u003C\u002Ftext>\n    \u003Ctext x=\"20.0\" y=\"157.2\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:start\">Warm build\u003C\u002Ftext>\n    \u003Ctext x=\"622.9\" y=\"146.5\" fill=\"#b32b30\" style=\"font-size:11.5px;text-anchor:start;font-weight:700\">139 s\u003C\u002Ftext>\n    \u003Ctext x=\"398.0\" y=\"166.5\" fill=\"#3f6410\" style=\"font-size:11.5px;text-anchor:start;font-weight:700\">58 s\u003C\u002Ftext>\n  \u003C\u002Fg>\n\u003C\u002Fsvg>\n\u003Cfigcaption>From the docs framework build-time comparison below; same corpus and runner for both.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>",{"k":27,"h":28,"items":29},"group","Choosing the Right Static Site Generator for Production",[30,35,39,44,48,52,56],{"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":43},"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":45,"u":46,"d":47,"y":43},"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":49,"u":50,"d":51,"y":43},"Speeding Up Docusaurus Builds With Rspack","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fspeeding-up-docusaurus-builds-with-rspack\u002F","Enable Docusaurus Faster (Rspack, SWC and Lightning CSS) on a large docs site, fix the plugins that break, and measure build time and memory before and after.",{"t":53,"u":54,"d":55,"y":43},"Versioned Documentation with Docusaurus","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioned-documentation-with-docusaurus\u002F","Cut a Docusaurus docs version, keep builds fast as versions pile up, archive old versions to static snapshots and route readers to the right one.",{"t":57,"u":58,"d":59,"y":60},"Fixing Broken Links Reported by Docusaurus Builds","\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Ffixing-broken-links-reported-by-docusaurus-builds\u002F","Read Docusaurus broken link and anchor reports, fix the common causes from relative paths to versioned docs, and make the build fail on new breaks.","Fix",{"k":24,"html":62},"\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 295\" role=\"img\" aria-labelledby=\"hub-docusaurus-kinds-title hub-docusaurus-kinds-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-docusaurus-kinds-title\">Number of Docusaurus guides of each kind\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-docusaurus-kinds-desc\">Vertical bars: How-tos 4, Fixes 1, Comparisons 2 and Concepts 0.\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=\"203.5\" width=\"90.0\" height=\"42.5\" rx=\"3\" fill=\"#ff595e\" opacity=\"0.3\" stroke=\"#d83b41\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"420.0\" y=\"161.0\" width=\"90.0\" height=\"85.0\" rx=\"3\" fill=\"#ffca3a\" opacity=\"0.45\" stroke=\"#a97b00\" style=\"stroke-width:1px\"\u002F>\n    \u003Crect x=\"590.0\" y=\"243.0\" width=\"90.0\" height=\"3.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\">Docusaurus 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\">4\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=\"196.5\" fill=\"#b32b30\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">1\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=\"154.0\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">2\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=\"236.0\" fill=\"#1f2937\" style=\"font-size:12px;text-anchor:middle;font-weight:700\">0\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>7 guides use Docusaurus in depth; each is listed below under the section it belongs to.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>",{"k":24,"html":64},"\u003Cfigure>\n\u003Csvg viewBox=\"0 0 760 142\" role=\"img\" aria-labelledby=\"hub-docusaurus-topics-title hub-docusaurus-topics-desc\" xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\n  \u003Ctitle id=\"hub-docusaurus-topics-title\">Topics with the most Docusaurus guides\u003C\u002Ftitle>\n  \u003Cdesc id=\"hub-docusaurus-topics-desc\">Horizontal bars, largest first: Docs Frameworks: Docusaurus, Starlight and VitePress 6 and Migrating Between Static Site Generators 1.\u003C\u002Fdesc>\n  \u003Crect x=\"0\" y=\"0\" width=\"760\" height=\"142\" 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=\"60.9\" 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 124.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 Docusaurus 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\">6\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=\"418.9\" y=\"113.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":66,"items":67},"Often used with Docusaurus",[68,73,78],{"t":69,"u":70,"d":71,"y":72},"Starlight","\u002Ftools\u002Fstarlight\u002F","Astro-based docs: overrides, translation and migration in.","4 shared guides",{"t":74,"u":75,"d":76,"y":77},"Astro","\u002Ftools\u002Fastro\u002F","Islands, content collections, astro:assets and deployment.","2 shared guides",{"t":79,"u":80,"d":81,"y":82},"VitePress","\u002Ftools\u002Fvitepress\u002F","Vue-based docs, compared on build time and page weight.","1 shared guides",1790943190467]