[{"data":1,"prerenderedAt":2143},["ShallowReactive",2],{"page:\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation":3,"all-docs-nav":1605},{"id":4,"title":5,"body":6,"breadcrumb":1583,"dateModified":1592,"datePublished":1592,"description":1593,"extension":805,"faq":1594,"meta":1599,"navigation":168,"path":1600,"seo":1601,"slug":12,"stem":1602,"type":1603,"__hash__":1604},"content\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation\u002Findex.md","VitePress for Library Documentation",{"type":7,"value":8,"toc":1566},"minimark",[9,13,17,26,31,52,56,63,116,407,425,429,440,559,611,622,790,794,801,828,934,941,944,948,955,1098,1111,1224,1247,1251,1254,1343,1431,1434,1438,1479,1483,1486,1490,1495,1498,1502,1505,1509,1512,1516,1519,1523,1562],[10,11,5],"h1",{"id":12},"vitepress-for-library-documentation",[14,15,16],"p",{},"A library's documentation has different needs from product docs. Readers are developers who arrive with an editor open, jump between the guide and the API reference dozens of times, copy code samples and expect them to run, and care which version of the package a page describes. The docs usually live in the same repository as the source, change in the same pull requests, and should build in the same CI job without doubling its duration.",[14,18,19,20,25],{},"VitePress fits that shape well: it drops into an existing npm workspace, builds a few hundred pages in seconds, and turns into a single-page app after the first load so moving between API pages is instant. This guide builds a library docs site with generated API reference, runnable samples and a version switcher, and measures the result. For the wider framework comparison, see ",[21,22,24],"a",{"href":23},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002F","Docs Frameworks: Docusaurus, Starlight and VitePress",".",[27,28,30],"h2",{"id":29},"prerequisites","Prerequisites",[32,33,34,38,41,44],"ul",{},[35,36,37],"li",{},"A TypeScript library in a Git repository, ideally an npm or pnpm workspace.",[35,39,40],{},"Node.js 20 or later.",[35,42,43],{},"TSDoc comments on the public API — the generated reference is only as good as the comments it reads.",[35,45,46,47,51],{},"A host that serves ",[48,49,50],"code",{},".html"," files for extensionless URLs if you enable clean URLs (Cloudflare, Netlify and Vercel all do).",[27,53,55],{"id":54},"step-1-add-vitepress-to-the-workspace","Step 1: Add VitePress to the Workspace",[14,57,58,59,62],{},"Put the docs in a ",[48,60,61],{},"docs\u002F"," workspace package so they share the library's toolchain and can import its source directly for live examples.",[64,65,70],"pre",{"className":66,"code":67,"language":68,"meta":69,"style":69},"language-bash shiki shiki-themes github-light github-dark","pnpm add -D vitepress --filter docs\npnpm --filter docs exec vitepress init\n","bash","",[48,71,72,98],{"__ignoreMap":69},[73,74,77,81,85,89,92,95],"span",{"class":75,"line":76},"line",1,[73,78,80],{"class":79},"sScJk","pnpm",[73,82,84],{"class":83},"sZZnC"," add",[73,86,88],{"class":87},"sj4cs"," -D",[73,90,91],{"class":83}," vitepress",[73,93,94],{"class":87}," --filter",[73,96,97],{"class":83}," docs\n",[73,99,101,103,105,108,111,113],{"class":75,"line":100},2,[73,102,80],{"class":79},[73,104,94],{"class":87},[73,106,107],{"class":83}," docs",[73,109,110],{"class":83}," exec",[73,112,91],{"class":83},[73,114,115],{"class":83}," init\n",[64,117,121],{"className":118,"code":119,"language":120,"meta":69,"style":69},"language-ts shiki shiki-themes github-light github-dark","\u002F\u002F docs\u002F.vitepress\u002Fconfig.ts\nimport { defineConfig } from 'vitepress';\nimport apiSidebar from '..\u002Fapi\u002Ftypedoc-sidebar.json';\n\nexport default defineConfig({\n  title: 'tinyqueue',\n  description: 'A tiny priority queue for TypeScript',\n  cleanUrls: true,\n  lastUpdated: true,\n  themeConfig: {\n    nav: [\n      { text: 'Guide', link: '\u002Fguide\u002F' },\n      { text: 'API', link: '\u002Fapi\u002F' },\n      { text: 'v3', items: [{ text: 'v2 docs', link: 'https:\u002F\u002Ftinyqueue.dev\u002Fv2\u002F' }] },\n    ],\n    sidebar: {\n      '\u002Fguide\u002F': [{ text: 'Guide', items: [\n        { text: 'Getting started', link: '\u002Fguide\u002F' },\n        { text: 'Comparators', link: '\u002Fguide\u002Fcomparators' },\n      ] }],\n      '\u002Fapi\u002F': apiSidebar,\n    },\n    search: { provider: 'local' },\n    editLink: { pattern: 'https:\u002F\u002Fgithub.com\u002Facme\u002Ftinyqueue\u002Fedit\u002Fmain\u002Fdocs\u002F:path' },\n  },\n});\n","ts",[48,122,123,129,148,163,170,185,197,208,219,229,235,241,259,274,296,302,308,322,337,352,358,367,373,384,395,401],{"__ignoreMap":69},[73,124,125],{"class":75,"line":76},[73,126,128],{"class":127},"sJ8bj","\u002F\u002F docs\u002F.vitepress\u002Fconfig.ts\n",[73,130,131,135,139,142,145],{"class":75,"line":100},[73,132,134],{"class":133},"szBVR","import",[73,136,138],{"class":137},"sVt8B"," { defineConfig } ",[73,140,141],{"class":133},"from",[73,143,144],{"class":83}," 'vitepress'",[73,146,147],{"class":137},";\n",[73,149,151,153,156,158,161],{"class":75,"line":150},3,[73,152,134],{"class":133},[73,154,155],{"class":137}," apiSidebar ",[73,157,141],{"class":133},[73,159,160],{"class":83}," '..\u002Fapi\u002Ftypedoc-sidebar.json'",[73,162,147],{"class":137},[73,164,166],{"class":75,"line":165},4,[73,167,169],{"emptyLinePlaceholder":168},true,"\n",[73,171,173,176,179,182],{"class":75,"line":172},5,[73,174,175],{"class":133},"export",[73,177,178],{"class":133}," default",[73,180,181],{"class":79}," defineConfig",[73,183,184],{"class":137},"({\n",[73,186,188,191,194],{"class":75,"line":187},6,[73,189,190],{"class":137},"  title: ",[73,192,193],{"class":83},"'tinyqueue'",[73,195,196],{"class":137},",\n",[73,198,200,203,206],{"class":75,"line":199},7,[73,201,202],{"class":137},"  description: ",[73,204,205],{"class":83},"'A tiny priority queue for TypeScript'",[73,207,196],{"class":137},[73,209,211,214,217],{"class":75,"line":210},8,[73,212,213],{"class":137},"  cleanUrls: ",[73,215,216],{"class":87},"true",[73,218,196],{"class":137},[73,220,222,225,227],{"class":75,"line":221},9,[73,223,224],{"class":137},"  lastUpdated: ",[73,226,216],{"class":87},[73,228,196],{"class":137},[73,230,232],{"class":75,"line":231},10,[73,233,234],{"class":137},"  themeConfig: {\n",[73,236,238],{"class":75,"line":237},11,[73,239,240],{"class":137},"    nav: [\n",[73,242,244,247,250,253,256],{"class":75,"line":243},12,[73,245,246],{"class":137},"      { text: ",[73,248,249],{"class":83},"'Guide'",[73,251,252],{"class":137},", link: ",[73,254,255],{"class":83},"'\u002Fguide\u002F'",[73,257,258],{"class":137}," },\n",[73,260,262,264,267,269,272],{"class":75,"line":261},13,[73,263,246],{"class":137},[73,265,266],{"class":83},"'API'",[73,268,252],{"class":137},[73,270,271],{"class":83},"'\u002Fapi\u002F'",[73,273,258],{"class":137},[73,275,277,279,282,285,288,290,293],{"class":75,"line":276},14,[73,278,246],{"class":137},[73,280,281],{"class":83},"'v3'",[73,283,284],{"class":137},", items: [{ text: ",[73,286,287],{"class":83},"'v2 docs'",[73,289,252],{"class":137},[73,291,292],{"class":83},"'https:\u002F\u002Ftinyqueue.dev\u002Fv2\u002F'",[73,294,295],{"class":137}," }] },\n",[73,297,299],{"class":75,"line":298},15,[73,300,301],{"class":137},"    ],\n",[73,303,305],{"class":75,"line":304},16,[73,306,307],{"class":137},"    sidebar: {\n",[73,309,311,314,317,319],{"class":75,"line":310},17,[73,312,313],{"class":83},"      '\u002Fguide\u002F'",[73,315,316],{"class":137},": [{ text: ",[73,318,249],{"class":83},[73,320,321],{"class":137},", items: [\n",[73,323,325,328,331,333,335],{"class":75,"line":324},18,[73,326,327],{"class":137},"        { text: ",[73,329,330],{"class":83},"'Getting started'",[73,332,252],{"class":137},[73,334,255],{"class":83},[73,336,258],{"class":137},[73,338,340,342,345,347,350],{"class":75,"line":339},19,[73,341,327],{"class":137},[73,343,344],{"class":83},"'Comparators'",[73,346,252],{"class":137},[73,348,349],{"class":83},"'\u002Fguide\u002Fcomparators'",[73,351,258],{"class":137},[73,353,355],{"class":75,"line":354},20,[73,356,357],{"class":137},"      ] }],\n",[73,359,361,364],{"class":75,"line":360},21,[73,362,363],{"class":83},"      '\u002Fapi\u002F'",[73,365,366],{"class":137},": apiSidebar,\n",[73,368,370],{"class":75,"line":369},22,[73,371,372],{"class":137},"    },\n",[73,374,376,379,382],{"class":75,"line":375},23,[73,377,378],{"class":137},"    search: { provider: ",[73,380,381],{"class":83},"'local'",[73,383,258],{"class":137},[73,385,387,390,393],{"class":75,"line":386},24,[73,388,389],{"class":137},"    editLink: { pattern: ",[73,391,392],{"class":83},"'https:\u002F\u002Fgithub.com\u002Facme\u002Ftinyqueue\u002Fedit\u002Fmain\u002Fdocs\u002F:path'",[73,394,258],{"class":137},[73,396,398],{"class":75,"line":397},25,[73,399,400],{"class":137},"  },\n",[73,402,404],{"class":75,"line":403},26,[73,405,406],{"class":137},"});\n",[14,408,409,412,413,416,417,420,421,25],{},[48,410,411],{},"cleanUrls: true"," makes links extensionless. The build still writes ",[48,414,415],{},"guide\u002Fcomparators.html",", so the host must resolve ",[48,418,419],{},"\u002Fguide\u002Fcomparators"," to that file; on a plain object store you will need the rewrite described in ",[21,422,424],{"href":423},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fclean-urls-and-trailing-slashes-on-s3\u002F","Clean URLs and Trailing Slashes on S3",[27,426,428],{"id":427},"step-2-generate-the-api-reference","Step 2: Generate the API Reference",[14,430,431,432,435,436,439],{},"TypeDoc reads the TSDoc comments; ",[48,433,434],{},"typedoc-plugin-markdown"," writes Markdown instead of HTML, and ",[48,437,438],{},"typedoc-vitepress-theme"," emits a sidebar file VitePress can import.",[64,441,445],{"className":442,"code":443,"language":444,"meta":69,"style":69},"language-json shiki shiki-themes github-light github-dark","\u002F\u002F docs\u002Ftypedoc.json\n{\n  \"entryPoints\": [\"..\u002Fsrc\u002Findex.ts\"],\n  \"out\": \".\u002Fapi\",\n  \"plugin\": [\"typedoc-plugin-markdown\", \"typedoc-vitepress-theme\"],\n  \"readme\": \"none\",\n  \"hidePageHeader\": true,\n  \"excludePrivate\": true,\n  \"sort\": [\"kind\", \"alphabetical\"]\n}\n","json",[48,446,447,452,457,471,484,502,514,525,536,554],{"__ignoreMap":69},[73,448,449],{"class":75,"line":76},[73,450,451],{"class":127},"\u002F\u002F docs\u002Ftypedoc.json\n",[73,453,454],{"class":75,"line":100},[73,455,456],{"class":137},"{\n",[73,458,459,462,465,468],{"class":75,"line":150},[73,460,461],{"class":87},"  \"entryPoints\"",[73,463,464],{"class":137},": [",[73,466,467],{"class":83},"\"..\u002Fsrc\u002Findex.ts\"",[73,469,470],{"class":137},"],\n",[73,472,473,476,479,482],{"class":75,"line":165},[73,474,475],{"class":87},"  \"out\"",[73,477,478],{"class":137},": ",[73,480,481],{"class":83},"\".\u002Fapi\"",[73,483,196],{"class":137},[73,485,486,489,491,494,497,500],{"class":75,"line":172},[73,487,488],{"class":87},"  \"plugin\"",[73,490,464],{"class":137},[73,492,493],{"class":83},"\"typedoc-plugin-markdown\"",[73,495,496],{"class":137},", ",[73,498,499],{"class":83},"\"typedoc-vitepress-theme\"",[73,501,470],{"class":137},[73,503,504,507,509,512],{"class":75,"line":187},[73,505,506],{"class":87},"  \"readme\"",[73,508,478],{"class":137},[73,510,511],{"class":83},"\"none\"",[73,513,196],{"class":137},[73,515,516,519,521,523],{"class":75,"line":199},[73,517,518],{"class":87},"  \"hidePageHeader\"",[73,520,478],{"class":137},[73,522,216],{"class":87},[73,524,196],{"class":137},[73,526,527,530,532,534],{"class":75,"line":210},[73,528,529],{"class":87},"  \"excludePrivate\"",[73,531,478],{"class":137},[73,533,216],{"class":87},[73,535,196],{"class":137},[73,537,538,541,543,546,548,551],{"class":75,"line":221},[73,539,540],{"class":87},"  \"sort\"",[73,542,464],{"class":137},[73,544,545],{"class":83},"\"kind\"",[73,547,496],{"class":137},[73,549,550],{"class":83},"\"alphabetical\"",[73,552,553],{"class":137},"]\n",[73,555,556],{"class":75,"line":231},[73,557,558],{"class":137},"}\n",[64,560,562],{"className":442,"code":561,"language":444,"meta":69,"style":69},"\u002F\u002F docs\u002Fpackage.json scripts\n{\n  \"api\": \"typedoc\",\n  \"build\": \"pnpm api && vitepress build\",\n  \"dev\": \"pnpm api && vitepress dev\"\n}\n",[48,563,564,569,573,585,597,607],{"__ignoreMap":69},[73,565,566],{"class":75,"line":76},[73,567,568],{"class":127},"\u002F\u002F docs\u002Fpackage.json scripts\n",[73,570,571],{"class":75,"line":100},[73,572,456],{"class":137},[73,574,575,578,580,583],{"class":75,"line":150},[73,576,577],{"class":87},"  \"api\"",[73,579,478],{"class":137},[73,581,582],{"class":83},"\"typedoc\"",[73,584,196],{"class":137},[73,586,587,590,592,595],{"class":75,"line":165},[73,588,589],{"class":87},"  \"build\"",[73,591,478],{"class":137},[73,593,594],{"class":83},"\"pnpm api && vitepress build\"",[73,596,196],{"class":137},[73,598,599,602,604],{"class":75,"line":172},[73,600,601],{"class":87},"  \"dev\"",[73,603,478],{"class":137},[73,605,606],{"class":83},"\"pnpm api && vitepress dev\"\n",[73,608,609],{"class":75,"line":187},[73,610,558],{"class":137},[14,612,613,614,617,618,621],{},"Commit nothing under ",[48,615,616],{},"docs\u002Fapi\u002F"," — add it to ",[48,619,620],{},".gitignore",". Generated pages in Git produce huge, meaningless diffs every time a comment changes, and reviewers stop reading them. The API reference is a build artefact like any other.",[623,624,625,786],"figure",{},[626,627,634,635,634,639,634,643,634,650,634,771],"svg",{"viewBox":628,"role":629,"ariaLabelledBy":630,"xmlns":633},"0 0 760 270","img",[631,632],"vpl-pipe-title","vpl-pipe-desc","http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg","\n  ",[636,637,638],"title",{"id":631},"From source comments to a docs site",[640,641,642],"desc",{"id":632},"A pipeline of four stages. TypeScript source with TSDoc comments feeds TypeDoc, which writes Markdown API pages and a sidebar JSON file. Those join the hand-written guide pages in VitePress, which builds static HTML. The API folder is generated and ignored by Git.",[644,645],"rect",{"x":646,"y":646,"width":647,"height":648,"fill":649},"0","760","270","#ffffff",[651,652,654,655,654,663,654,673,654,679,654,685,654,689,654,693,654,696,654,704,654,710,654,713,654,717,654,722,654,726,654,733,654,738,654,742,654,767,634],"g",{"style":653},"font-family:system-ui, sans-serif;font-size:12px","\n    ",[656,657,662],"text",{"x":658,"y":659,"fill":660,"style":661},"380","28","#1f2937","font-size:16px;font-weight:700;text-anchor:middle","The reference is generated on every build, never committed",[644,664],{"x":665,"y":666,"width":667,"height":668,"rx":669,"fill":670,"opacity":671,"stroke":670,"style":672},"20","70","150","64","10","#1982c4","0.14","stroke-width:1.5px",[656,674,678],{"x":675,"y":676,"fill":660,"style":677},"95","96","font-weight:700;text-anchor:middle","src\u002F*.ts",[656,680,684],{"x":675,"y":681,"fill":682,"style":683},"116","#556071","font-size:11px;text-anchor:middle","TSDoc comments",[644,686],{"x":687,"y":666,"width":667,"height":668,"rx":669,"fill":688,"opacity":671,"stroke":688,"style":672},"210","#6a4c93",[656,690,692],{"x":691,"y":676,"fill":660,"style":677},"285","TypeDoc",[656,694,695],{"x":691,"y":681,"fill":682,"style":683},"markdown plugin · 9 s",[644,697],{"x":698,"y":699,"width":667,"height":700,"rx":669,"fill":701,"opacity":702,"stroke":703,"style":672},"400","50","46","#ffca3a","0.26","#a97b00",[656,705,709],{"x":706,"y":707,"fill":660,"style":708},"475","78","text-anchor:middle","api\u002F*.md (310)",[644,711],{"x":698,"y":712,"width":667,"height":700,"rx":669,"fill":701,"opacity":702,"stroke":703,"style":672},"108",[656,714,716],{"x":706,"y":715,"fill":660,"style":708},"136","typedoc-sidebar.json",[644,718],{"x":698,"y":719,"width":667,"height":700,"rx":669,"fill":720,"stroke":721,"style":672},"176","#f8fafc","#d9e2ef",[656,723,725],{"x":706,"y":724,"fill":660,"style":708},"204","guide\u002F*.md (110)",[644,727],{"x":728,"y":729,"width":667,"height":668,"rx":669,"fill":730,"opacity":731,"stroke":732,"style":672},"590","100","#8ac926","0.18","#5a8a16",[656,734,737],{"x":735,"y":736,"fill":660,"style":677},"665","126","vitepress build",[656,739,741],{"x":735,"y":740,"fill":682,"style":683},"146","420 pages · 11 s",[651,743,746,747,746,752,746,755,746,758,746,761,746,764,654],{"stroke":682,"fill":744,"style":745},"none","stroke-width:2px","\n      ",[748,749],"path",{"d":750,"style":751},"M172 102 L206 102","marker-end:url(#vpl-arrow)",[748,753],{"d":754,"style":751},"M362 94 L396 76",[748,756],{"d":757,"style":751},"M362 110 L396 128",[748,759],{"d":760,"style":751},"M552 74 L588 116",[748,762],{"d":763,"style":751},"M552 131 L586 131",[748,765],{"d":766,"style":751},"M552 199 L588 150",[656,768,770],{"x":706,"y":769,"fill":682,"style":683},"252","yellow = generated, gitignored · grey = hand-written",[772,773,654,774,634],"defs",{},[775,776,746,783,654],"marker",{"id":777,"viewBox":778,"refX":779,"refY":780,"markerWidth":781,"markerHeight":781,"orient":782},"vpl-arrow","0 0 10 10","8","5","7","auto-start-reverse",[748,784],{"d":785,"fill":682},"M0 0 L10 5 L0 10 z",[787,788,789],"figcaption",{},"Twenty seconds from comment to deployable HTML, which is short enough to run in the same CI job as the library's tests.",[27,791,793],{"id":792},"step-3-make-code-samples-real","Step 3: Make Code Samples Real",[14,795,796,797,800],{},"The most damaging defect in library docs is a sample that no longer compiles. VitePress can import code regions from real files with the ",[48,798,799],{},"\u003C\u003C\u003C"," snippet syntax, so samples live in a tested directory rather than in Markdown:",[64,802,806],{"className":803,"code":804,"language":805,"meta":69,"style":69},"language-md shiki shiki-themes github-light github-dark","\u003C!-- docs\u002Fguide\u002Fcomparators.md -->\n## Custom comparators\n\n\u003C\u003C\u003C @\u002F..\u002Fexamples\u002Fcomparator.ts#by-priority{ts}\n","md",[48,807,808,813,819,823],{"__ignoreMap":69},[73,809,810],{"class":75,"line":76},[73,811,812],{"class":127},"\u003C!-- docs\u002Fguide\u002Fcomparators.md -->\n",[73,814,815],{"class":75,"line":100},[73,816,818],{"class":817},"sq-ep","## Custom comparators\n",[73,820,821],{"class":75,"line":150},[73,822,169],{"emptyLinePlaceholder":168},[73,824,825],{"class":75,"line":165},[73,826,827],{"class":137},"\u003C\u003C\u003C @\u002F..\u002Fexamples\u002Fcomparator.ts#by-priority{ts}\n",[64,829,831],{"className":118,"code":830,"language":120,"meta":69,"style":69},"\u002F\u002F examples\u002Fcomparator.ts — also run by `pnpm test:examples`\n\u002F\u002F #region by-priority\nimport { TinyQueue } from 'tinyqueue';\nconst q = new TinyQueue\u003CJob>([], (a, b) => a.priority - b.priority);\nq.push({ id: 'build', priority: 2 });\n\u002F\u002F #endregion by-priority\n",[48,832,833,838,843,857,906,929],{"__ignoreMap":69},[73,834,835],{"class":75,"line":76},[73,836,837],{"class":127},"\u002F\u002F examples\u002Fcomparator.ts — also run by `pnpm test:examples`\n",[73,839,840],{"class":75,"line":100},[73,841,842],{"class":127},"\u002F\u002F #region by-priority\n",[73,844,845,847,850,852,855],{"class":75,"line":150},[73,846,134],{"class":133},[73,848,849],{"class":137}," { TinyQueue } ",[73,851,141],{"class":133},[73,853,854],{"class":83}," 'tinyqueue'",[73,856,147],{"class":137},[73,858,859,862,865,868,871,874,877,880,883,886,888,891,894,897,900,903],{"class":75,"line":165},[73,860,861],{"class":133},"const",[73,863,864],{"class":87}," q",[73,866,867],{"class":133}," =",[73,869,870],{"class":133}," new",[73,872,873],{"class":79}," TinyQueue",[73,875,876],{"class":137},"\u003C",[73,878,879],{"class":79},"Job",[73,881,882],{"class":137},">([], (",[73,884,21],{"class":885},"s4XuR",[73,887,496],{"class":137},[73,889,890],{"class":885},"b",[73,892,893],{"class":137},") ",[73,895,896],{"class":133},"=>",[73,898,899],{"class":137}," a.priority ",[73,901,902],{"class":133},"-",[73,904,905],{"class":137}," b.priority);\n",[73,907,908,911,914,917,920,923,926],{"class":75,"line":172},[73,909,910],{"class":137},"q.",[73,912,913],{"class":79},"push",[73,915,916],{"class":137},"({ id: ",[73,918,919],{"class":83},"'build'",[73,921,922],{"class":137},", priority: ",[73,924,925],{"class":87},"2",[73,927,928],{"class":137}," });\n",[73,930,931],{"class":75,"line":187},[73,932,933],{"class":127},"\u002F\u002F #endregion by-priority\n",[14,935,936,937,940],{},"The ",[48,938,939],{},"examples\u002F"," directory is type-checked and executed in CI. When an API change breaks a sample, the test fails in the same pull request that changed the API, not months later in a user's bug report. On one library this caught eleven stale samples in its first week.",[14,942,943],{},"For interactive demos, VitePress renders Vue components inline in Markdown. Keep them few: each one adds to the JavaScript the page hydrates, and most library docs need a runnable playground on two or three pages, not on every page.",[27,945,947],{"id":946},"step-4-versioned-deploys","Step 4: Versioned Deploys",[14,949,950,951,954],{},"VitePress has no built-in versioning. The reliable pattern is one long-lived branch per supported major version, each building with a different ",[48,952,953],{},"base",":",[64,956,960],{"className":957,"code":958,"language":959,"meta":69,"style":69},"language-yaml shiki shiki-themes github-light github-dark","# .github\u002Fworkflows\u002Fdocs.yml (excerpt)\nstrategy:\n  matrix:\n    include:\n      - { branch: main, base: \u002F }\n      - { branch: v2, base: \u002Fv2\u002F }\nsteps:\n  - uses: actions\u002Fcheckout@v4\n    with: { ref: '${{ matrix.branch }}' }\n  - run: pnpm install --frozen-lockfile\n  - run: pnpm --filter docs build -- --base ${{ matrix.base }}\n","yaml",[48,961,962,967,976,983,990,1015,1037,1044,1057,1075,1087],{"__ignoreMap":69},[73,963,964],{"class":75,"line":76},[73,965,966],{"class":127},"# .github\u002Fworkflows\u002Fdocs.yml (excerpt)\n",[73,968,969,973],{"class":75,"line":100},[73,970,972],{"class":971},"s9eBZ","strategy",[73,974,975],{"class":137},":\n",[73,977,978,981],{"class":75,"line":150},[73,979,980],{"class":971},"  matrix",[73,982,975],{"class":137},[73,984,985,988],{"class":75,"line":165},[73,986,987],{"class":971},"    include",[73,989,975],{"class":137},[73,991,992,995,998,1000,1003,1005,1007,1009,1012],{"class":75,"line":172},[73,993,994],{"class":137},"      - { ",[73,996,997],{"class":971},"branch",[73,999,478],{"class":137},[73,1001,1002],{"class":83},"main",[73,1004,496],{"class":137},[73,1006,953],{"class":971},[73,1008,478],{"class":137},[73,1010,1011],{"class":83},"\u002F",[73,1013,1014],{"class":137}," }\n",[73,1016,1017,1019,1021,1023,1026,1028,1030,1032,1035],{"class":75,"line":187},[73,1018,994],{"class":137},[73,1020,997],{"class":971},[73,1022,478],{"class":137},[73,1024,1025],{"class":83},"v2",[73,1027,496],{"class":137},[73,1029,953],{"class":971},[73,1031,478],{"class":137},[73,1033,1034],{"class":83},"\u002Fv2\u002F",[73,1036,1014],{"class":137},[73,1038,1039,1042],{"class":75,"line":199},[73,1040,1041],{"class":971},"steps",[73,1043,975],{"class":137},[73,1045,1046,1049,1052,1054],{"class":75,"line":210},[73,1047,1048],{"class":137},"  - ",[73,1050,1051],{"class":971},"uses",[73,1053,478],{"class":137},[73,1055,1056],{"class":83},"actions\u002Fcheckout@v4\n",[73,1058,1059,1062,1065,1068,1070,1073],{"class":75,"line":221},[73,1060,1061],{"class":971},"    with",[73,1063,1064],{"class":137},": { ",[73,1066,1067],{"class":971},"ref",[73,1069,478],{"class":137},[73,1071,1072],{"class":83},"'${{ matrix.branch }}'",[73,1074,1014],{"class":137},[73,1076,1077,1079,1082,1084],{"class":75,"line":231},[73,1078,1048],{"class":137},[73,1080,1081],{"class":971},"run",[73,1083,478],{"class":137},[73,1085,1086],{"class":83},"pnpm install --frozen-lockfile\n",[73,1088,1089,1091,1093,1095],{"class":75,"line":237},[73,1090,1048],{"class":137},[73,1092,1081],{"class":971},[73,1094,478],{"class":137},[73,1096,1097],{"class":83},"pnpm --filter docs build -- --base ${{ matrix.base }}\n",[14,1099,1100,1101,1103,1104,1106,1107,25],{},"Both outputs are merged into one artifact and deployed together, so ",[48,1102,1011],{}," and ",[48,1105,1034],{}," are always consistent. The matrix pattern is covered in ",[21,1108,1110],{"href":1109},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fmatrix-builds-for-multi-site-monorepos\u002F","Matrix Builds for Multi-Site Monorepos",[623,1112,1113,1221],{},[626,1114,634,1119,634,1122,634,1125,634,1128,634,1214],{"viewBox":1115,"role":629,"ariaLabelledBy":1116,"xmlns":633},"0 0 760 250",[1117,1118],"vpl-ver-title","vpl-ver-desc",[636,1120,1121],{"id":1117},"Branch-per-major versioning with one deploy",[640,1123,1124],{"id":1118},"Two branches, main and v2, each build VitePress with a different base path in parallel matrix jobs. A merge job combines the two outputs into one artifact with the root path for main and the \u002Fv2\u002F path for the old major, and deploys it atomically.",[644,1126],{"x":646,"y":646,"width":647,"height":1127,"fill":649},"250",[651,1129,654,1130,654,1133,654,1137,654,1142,654,1144,654,1148,654,1152,654,1157,654,1160,654,1162,654,1166,654,1170,654,1174,654,1178,654,1182,654,1185,654,1189,654,1192,654,1210,634],{"style":653},[656,1131,1132],{"x":658,"y":659,"fill":660,"style":661},"Two branches, two builds, one atomic deploy",[644,1134],{"x":1135,"y":1136,"width":667,"height":699,"rx":669,"fill":670,"opacity":671,"stroke":670,"style":672},"30","60",[656,1138,1141],{"x":1139,"y":1140,"fill":660,"style":677},"105","90","branch main",[644,1143],{"x":1135,"y":667,"width":667,"height":699,"rx":669,"fill":720,"stroke":721,"style":672},[656,1145,1147],{"x":1139,"y":1146,"fill":660,"style":677},"180","branch v2",[644,1149],{"x":1150,"y":1136,"width":1146,"height":699,"rx":669,"fill":688,"opacity":1151,"stroke":688,"style":672},"240","0.12",[656,1153,1156],{"x":1154,"y":1155,"fill":660,"style":708},"330","82","build --base \u002F",[656,1158,1159],{"x":1154,"y":729,"fill":682,"style":683},"matrix job 1",[644,1161],{"x":1150,"y":667,"width":1146,"height":699,"rx":669,"fill":688,"opacity":1151,"stroke":688,"style":672},[656,1163,1165],{"x":1154,"y":1164,"fill":660,"style":708},"172","build --base \u002Fv2\u002F",[656,1167,1169],{"x":1154,"y":1168,"fill":682,"style":683},"190","matrix job 2",[644,1171],{"x":1172,"y":729,"width":1173,"height":1136,"rx":669,"fill":701,"opacity":702,"stroke":703,"style":672},"480","120",[656,1175,1177],{"x":1176,"y":736,"fill":660,"style":677},"540","merge",[656,1179,1181],{"x":1176,"y":1180,"fill":682,"style":683},"144","one artifact",[644,1183],{"x":1184,"y":729,"width":729,"height":1136,"rx":669,"fill":730,"opacity":731,"stroke":732,"style":672},"640",[656,1186,1188],{"x":1187,"y":736,"fill":660,"style":677},"690","deploy",[656,1190,1191],{"x":1187,"y":1180,"fill":682,"style":683},"atomic",[651,1193,746,1194,746,1198,746,1201,746,1204,746,1207,654],{"stroke":682,"fill":744,"style":745},[748,1195],{"d":1196,"style":1197},"M182 85 L236 85","marker-end:url(#vpl-ver-arrow)",[748,1199],{"d":1200,"style":1197},"M182 175 L236 175",[748,1202],{"d":1203,"style":1197},"M422 85 L476 118",[748,1205],{"d":1206,"style":1197},"M422 175 L476 142",[748,1208],{"d":1209,"style":1197},"M602 130 L636 130",[656,1211,1213],{"x":658,"y":1212,"fill":682,"style":683},"234","A fix merged to v2 redeploys both versions, so the two paths can never drift out of step",[772,1215,654,1216,634],{},[775,1217,746,1219,654],{"id":1218,"viewBox":778,"refX":779,"refY":780,"markerWidth":781,"markerHeight":781,"orient":782},"vpl-ver-arrow",[748,1220],{"d":785,"fill":682},[787,1222,1223],{},"Deploying both versions together costs one extra matrix job and removes a whole class of half-deployed states.",[14,1225,1226,1227,1231,1232,1234,1235,1237,1238,1240,1241,1243,1244,1246],{},"Two details make this robust. First, trigger the workflow on pushes to ",[1228,1229,1230],"em",{},"any"," supported branch, not only ",[48,1233,1002],{},", so a documentation fix merged into ",[48,1236,1025],{}," goes live without waiting for the next release of v3. Second, give every version's layout a banner component that reads the ",[48,1239,953],{}," at build time and, on anything other than ",[48,1242,1011],{},", links to the same page in the current major. Readers who land on ",[48,1245,1034],{}," from an old search result then have a one-click route forward, and the team avoids maintaining that link by hand. When a major version leaves support, freeze its final build into a static folder and drop it from the matrix, exactly as with archived Docusaurus versions — the pages stay reachable and the build stops paying for them.",[27,1248,1250],{"id":1249},"measured-impact","Measured Impact",[14,1252,1253],{},"The library's docs moved from a hand-maintained README plus a TypeDoc HTML site to VitePress. Numbers are from GitHub Actions timings and Lighthouse 12 mobile medians over five runs.",[1255,1256,1257,1273],"table",{},[1258,1259,1260],"thead",{},[1261,1262,1263,1267,1270],"tr",{},[1264,1265,1266],"th",{},"Measure",[1264,1268,1269],{},"Before (README + TypeDoc HTML)",[1264,1271,1272],{},"After (VitePress)",[1274,1275,1276,1288,1299,1310,1321,1332],"tbody",{},[1261,1277,1278,1282,1285],{},[1279,1280,1281],"td",{},"Docs build time in CI",[1279,1283,1284],{},"14 s (TypeDoc HTML only)",[1279,1286,1287],{},"20 s (TypeDoc + VitePress)",[1261,1289,1290,1293,1296],{},[1279,1291,1292],{},"Pages",[1279,1294,1295],{},"1 README + 310 API pages, unlinked",[1279,1297,1298],{},"420 pages, one navigation",[1261,1300,1301,1304,1307],{},[1279,1302,1303],{},"First-load JS, API page",[1279,1305,1306],{},"41 KB",[1279,1308,1309],{},"62 KB",[1261,1311,1312,1315,1318],{},[1279,1313,1314],{},"Navigation between API pages",[1279,1316,1317],{},"full reload, ~600 ms",[1279,1319,1320],{},"client-side, ~40 ms",[1261,1322,1323,1326,1329],{},[1279,1324,1325],{},"Stale samples found by CI",[1279,1327,1328],{},"not tested",[1279,1330,1331],{},"11 fixed in week one",[1261,1333,1334,1337,1340],{},[1279,1335,1336],{},"Docs-related issues per month",[1279,1338,1339],{},"9",[1279,1341,1342],{},"3",[623,1344,1345,1428],{},[626,1346,634,1350,634,1353,634,1356,634,1358],{"viewBox":628,"role":629,"ariaLabelledBy":1347,"xmlns":633},[1348,1349],"vpl-nav-title","vpl-nav-desc",[636,1351,1352],{"id":1348},"First load versus later navigation cost",[640,1354,1355],{"id":1349},"A comparison of a reader session visiting five API pages. The old multi-page site cost about 600 milliseconds per page, 3 seconds in total. VitePress cost about 1.1 seconds for the first page and about 40 milliseconds for each of the next four, about 1.3 seconds in total.",[644,1357],{"x":646,"y":646,"width":647,"height":648,"fill":649},[651,1359,654,1360,654,1363,654,1368,654,1375,654,1377,654,1380,654,1383,654,1386,654,1392,654,1396,654,1400,654,1405,654,1408,654,1411,654,1414,654,1417,654,1421,654,1425,634],{"style":653},[656,1361,1362],{"x":658,"y":659,"fill":660,"style":661},"A five-page API session: where the waiting happens",[656,1364,1367],{"x":1135,"y":1365,"fill":660,"style":1366},"84","font-weight:700","Old site",[644,1369],{"x":667,"y":1370,"width":729,"height":659,"fill":1371,"opacity":1372,"stroke":1373,"style":1374},"66","#ff595e","0.22","#d83b41","stroke-width:1px",[644,1376],{"x":769,"y":1370,"width":729,"height":659,"fill":1371,"opacity":1372,"stroke":1373,"style":1374},[644,1378],{"x":1379,"y":1370,"width":729,"height":659,"fill":1371,"opacity":1372,"stroke":1373,"style":1374},"354",[644,1381],{"x":1382,"y":1370,"width":729,"height":659,"fill":1371,"opacity":1372,"stroke":1373,"style":1374},"456",[644,1384],{"x":1385,"y":1370,"width":729,"height":659,"fill":1371,"opacity":1372,"stroke":1373,"style":1374},"558",[656,1387,1391],{"x":1388,"y":1389,"fill":1390,"style":1366},"668","85","#b32b30","3.0 s",[656,1393,1395],{"x":1135,"y":1394,"fill":660,"style":1366},"154","VitePress",[644,1397],{"x":667,"y":715,"width":1398,"height":659,"fill":701,"opacity":1399,"stroke":703,"style":1374},"183","0.3",[656,1401,1404],{"x":1402,"y":1403,"fill":660,"style":708},"241","155","first load 1.1 s",[644,1406],{"x":1407,"y":715,"width":781,"height":659,"fill":730,"stroke":732,"style":1374},"335",[644,1409],{"x":1410,"y":715,"width":781,"height":659,"fill":730,"stroke":732,"style":1374},"344",[644,1412],{"x":1413,"y":715,"width":781,"height":659,"fill":730,"stroke":732,"style":1374},"353",[644,1415],{"x":1416,"y":715,"width":781,"height":659,"fill":730,"stroke":732,"style":1374},"362",[656,1418,1420],{"x":658,"y":1403,"fill":1419,"style":1366},"#3f6410","1.3 s",[656,1422,1424],{"x":658,"y":1168,"fill":682,"style":1423},"font-size:11px","4 × ~40 ms client-side route changes",[656,1426,1427],{"x":658,"y":1150,"fill":682,"style":683},"Chrome DevTools, Moto G Power profile, warm HTTP cache disabled between sessions",[787,1429,1430],{},"VitePress pays more up front and far less afterwards — the right trade for readers who browse the reference rather than land on one page.",[14,1432,1433],{},"The first-load JavaScript rose by 21 KB, which is the price of the client-side router. For a library whose readers typically view six to ten reference pages per session, that is a clear win; for a site where most visits are a single page from search, the calculation reverses, and Starlight's near-zero JavaScript is the better default.",[27,1435,1437],{"id":1436},"pitfalls-rollback","Pitfalls & Rollback",[32,1439,1440,1447,1457,1467,1473],{},[35,1441,1442,1446],{},[1443,1444,1445],"strong",{},"Committing generated API pages."," They bloat diffs and go stale when someone forgets to regenerate. Generate in the build and gitignore the output.",[35,1448,1449,1452,1453,25],{},[1443,1450,1451],{},"Deploying without old chunks."," After a deploy, open tabs request chunk files from the previous build. Use an atomic host that keeps prior assets, or readers see failed navigations until they reload — see ",[21,1454,1456],{"href":1455},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fatomic-deploys-vs-incremental-uploads\u002F","Atomic Deploys vs Incremental Uploads",[35,1458,1459,1462,1463,25],{},[1443,1460,1461],{},"Local search on huge sites."," The built-in MiniSearch index is bundled into JavaScript and grows with content; past about 1,000 pages consider Pagefind, as discussed in ",[21,1464,1466],{"href":1465},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fsearch-index-size-budgets-for-large-docs\u002F","Search Index Size Budgets for Large Docs",[35,1468,1469,1472],{},[1443,1470,1471],{},"Vue components everywhere."," Each inline component adds hydration work; keep interactive demos to the pages that need them.",[35,1474,1475,1478],{},[1443,1476,1477],{},"Rollback:"," the docs are one workspace package and one CI job. Reverting the pull request that added them restores the previous docs pipeline; the TypeDoc HTML output can be regenerated from the same comments at any time.",[27,1480,1482],{"id":1481},"conclusion","Conclusion",[14,1484,1485],{},"For library documentation that lives with its source, VitePress offers the shortest path from TSDoc comments to a fast, navigable site: TypeDoc generates the reference, snippet imports keep samples tested, a branch-per-major matrix handles versions, and the whole pipeline adds about twenty seconds to CI. Accept the modest first-load JavaScript cost when your readers browse; prefer Starlight when they arrive from search and leave after one page.",[27,1487,1489],{"id":1488},"faq","FAQ",[1491,1492,1494],"h3",{"id":1493},"why-use-vitepress-rather-than-starlight-for-a-library","Why use VitePress rather than Starlight for a library?",[14,1496,1497],{},"VitePress lives comfortably inside a library's existing Vite or npm workspace, builds very quickly, and its client-side navigation makes jumping between API pages feel instant. Starlight ships less JavaScript on first load, so it wins when first-visit performance matters more than repeat navigation.",[1491,1499,1501],{"id":1500},"how-do-i-generate-api-reference-pages","How do I generate API reference pages?",[14,1503,1504],{},"Run TypeDoc with the typedoc-plugin-markdown plugin before the VitePress build. It writes one Markdown file per module or class into the docs folder, and a small script turns its output into a sidebar.",[1491,1506,1508],{"id":1507},"does-vitepress-support-versioned-docs","Does VitePress support versioned docs?",[14,1510,1511],{},"Not natively. The common approach is to build each major version from its own branch and deploy it under a path such as \u002Fv2\u002F, with a version link in the navigation pointing between them.",[1491,1513,1515],{"id":1514},"how-fast-is-a-vitepress-build","How fast is a VitePress build?",[14,1517,1518],{},"Fast. A 420-page library site including 310 generated API pages built in 11 seconds on a GitHub Actions runner, and the TypeDoc step before it took another 9 seconds.",[27,1520,1522],{"id":1521},"related","Related",[32,1524,1525,1534,1541,1548,1555],{},[35,1526,1527,1530,1531,1533],{},[1443,1528,1529],{},"Parent:"," ",[21,1532,24],{"href":23}," — the three-way comparison.",[35,1535,1536,1540],{},[21,1537,1539],{"href":1538},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fchoosing-an-ssg-for-api-reference-documentation\u002F","Choosing an SSG for API Reference Documentation"," — the reference-docs decision in general.",[35,1542,1543,1547],{},[21,1544,1546],{"href":1545},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content\u002F","MDX vs Markdoc for Docs Content"," — component syntax choices in docs.",[35,1549,1550,1554],{},[21,1551,1553],{"href":1552},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Finstant-navigation-with-speculation-rules\u002F","Instant Navigation with Speculation Rules"," — fast navigation without a client router.",[35,1556,1557,1561],{},[21,1558,1560],{"href":1559},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioned-documentation-with-docusaurus\u002F","Versioned Documentation with Docusaurus"," — the built-in alternative to branch-per-version.",[1563,1564,1565],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sq-ep, html code.shiki .sq-ep{--shiki-default:#005CC5;--shiki-default-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":69,"searchDepth":100,"depth":100,"links":1567},[1568,1569,1570,1571,1572,1573,1574,1575,1576,1582],{"id":29,"depth":100,"text":30},{"id":54,"depth":100,"text":55},{"id":427,"depth":100,"text":428},{"id":792,"depth":100,"text":793},{"id":946,"depth":100,"text":947},{"id":1249,"depth":100,"text":1250},{"id":1436,"depth":100,"text":1437},{"id":1481,"depth":100,"text":1482},{"id":1488,"depth":100,"text":1489,"children":1577},[1578,1579,1580,1581],{"id":1493,"depth":150,"text":1494},{"id":1500,"depth":150,"text":1501},{"id":1507,"depth":150,"text":1508},{"id":1514,"depth":150,"text":1515},{"id":1521,"depth":100,"text":1522},[1584,1586,1589,1590],{"name":1585,"item":1011},"Home",{"name":1587,"item":1588},"Choosing the Right Static Site Generator for Production","\u002Fchoosing-the-right-static-site-generator-for-production\u002F",{"name":24,"item":23},{"name":5,"item":1591},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation\u002F","2026-09-18","Set up VitePress docs next to a library's source: generated API reference from TypeDoc, live code samples, versioned deploys and sub-20-second builds.",[1595,1596,1597,1598],{"q":1494,"a":1497},{"q":1501,"a":1504},{"q":1508,"a":1511},{"q":1515,"a":1518},{},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation",{"title":5,"description":1593},"choosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation\u002Findex","article","dTJdVjP_u8a5kTdFzZ73h4bycnfXMtLIYlb_RuFP1GU",[1606,1609,1612,1615,1618,1621,1624,1627,1630,1632,1634,1637,1639,1640,1643,1646,1649,1652,1655,1658,1660,1663,1666,1669,1672,1675,1678,1681,1684,1687,1690,1693,1696,1699,1702,1705,1708,1711,1714,1717,1720,1723,1726,1729,1732,1735,1738,1740,1743,1745,1748,1751,1754,1757,1760,1763,1766,1769,1772,1775,1778,1781,1784,1787,1790,1793,1796,1799,1802,1805,1808,1811,1814,1817,1820,1823,1826,1829,1832,1835,1838,1841,1844,1847,1850,1853,1856,1859,1862,1865,1868,1871,1874,1877,1880,1883,1886,1889,1892,1895,1898,1901,1904,1906,1909,1912,1915,1918,1921,1924,1927,1930,1933,1936,1939,1942,1945,1948,1951,1954,1957,1960,1963,1966,1969,1972,1975,1978,1981,1984,1987,1989,1992,1995,1998,2001,2004,2007,2010,2013,2016,2019,2022,2025,2028,2031,2034,2037,2040,2043,2046,2049,2052,2055,2058,2061,2064,2067,2069,2072,2075,2078,2081,2084,2087,2090,2093,2096,2099,2102,2105,2107,2110,2113,2116,2119,2122,2125,2128,2131,2134,2137,2140],{"path":1607,"title":1608},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fastro-vs-eleventy-build-times-at-10000-pages","Astro vs Eleventy Build Times at 10,000 Pages",{"path":1610,"title":1611},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fchoosing-between-astro-and-eleventy-for-large-docs","Astro vs Eleventy for Large Docs (1000+ Pages)",{"path":1613,"title":1614},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fcontent-collections-vs-eleventy-data-cascade","Content Collections vs the Eleventy Data Cascade",{"path":1616,"title":1617},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites","Astro vs Eleventy for Documentation Sites",{"path":1619,"title":1620},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fshortcodes-vs-components-for-docs-authors","Shortcodes vs Components for Docs Authors",{"path":1622,"title":1623},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fsidebar-navigation-in-astro-and-eleventy","Sidebar Navigation in Astro and Eleventy",{"path":1625,"title":1626},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcustomizing-starlight-without-forking-the-theme","Customizing Starlight Without Forking the Theme",{"path":1628,"title":1629},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fdocusaurus-vs-starlight-for-product-documentation","Docusaurus vs Starlight for Product Documentation",{"path":1631,"title":24},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress",{"path":1633,"title":1546},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content",{"path":1635,"title":1636},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmigrating-from-mkdocs-to-starlight","Migrating from MkDocs to Starlight",{"path":1638,"title":1560},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioned-documentation-with-docusaurus",{"path":1600,"title":5},{"path":1641,"title":1642},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhow-to-benchmark-hugo-vs-astro-build-speeds","How to Benchmark Hugo vs Astro Build Speeds",{"path":1644,"title":1645},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhugo-partialcached-for-faster-builds","Hugo partialCached for Faster Builds",{"path":1647,"title":1648},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories","Hugo Build Times for Large Repositories",{"path":1650,"title":1651},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fprofiling-hugo-templates-with-template-metrics","Profiling Hugo Templates With Template Metrics",{"path":1653,"title":1654},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Freducing-hugo-memory-usage-on-ci-runners","Reducing Hugo Memory Usage on CI Runners",{"path":1656,"title":1657},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fspeeding-up-hugo-builds-with-render-hooks-and-caching","Speeding Up Hugo Builds with Render Hooks & Caching",{"path":1659,"title":1587},"\u002Fchoosing-the-right-static-site-generator-for-production",{"path":1661,"title":1662},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Feleventy-vs-jekyll-for-markdown-heavy-blogs","Eleventy vs Jekyll for Markdown-Heavy Blogs",{"path":1664,"title":1665},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem","Jekyll Plugin Ecosystem",{"path":1667,"title":1668},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Freplacing-jekyll-plugins-when-migrating-to-eleventy","Replacing Jekyll Plugins When Migrating to Eleventy",{"path":1670,"title":1671},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Frunning-jekyll-on-github-pages-without-plugins","Running Jekyll on GitHub Pages Without Plugins",{"path":1673,"title":1674},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fspeeding-up-slow-jekyll-builds","Speeding Up Slow Jekyll Builds",{"path":1676,"title":1677},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fupgrading-jekyll-and-ruby-versions-safely","Upgrading Jekyll and Ruby Versions Safely",{"path":1679,"title":1680},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fconverting-front-matter-at-scale-during-migration","Converting Front Matter at Scale During Migration",{"path":1682,"title":1683},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators","Migrating Between Static Site Generators",{"path":1685,"title":1686},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fkeeping-redirects-working-after-an-ssg-migration","Keeping Redirects Working After an SSG Migration",{"path":1688,"title":1689},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-a-docs-site-from-jekyll-to-hugo","Migrating a Docs Site From Jekyll to Hugo",{"path":1691,"title":1692},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-gatsby-to-astro","Migrating from Gatsby to Astro",{"path":1694,"title":1695},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-hugo-to-astro-without-breaking-urls","Migrating From Hugo to Astro Without Breaking URLs",{"path":1697,"title":1698},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-wordpress-to-a-static-site-generator","Migrating WordPress to a Static Site Generator",{"path":1700,"title":1701},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fporting-shortcodes-and-includes-between-generators","Porting Shortcodes and Includes Between Generators",{"path":1703,"title":1704},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fhandling-dynamic-routes-in-nextjs-static-export","Handling Dynamic Routes in Next.js Static Export",{"path":1706,"title":1707},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites","Next.js Static Export for Content Sites",{"path":1709,"title":1710},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fmigrating-from-gatsby-to-nextjs-static-export","Migrating from Gatsby to Next.js Static Export",{"path":1712,"title":1713},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-app-router-static-export-limitations","Next.js App Router Static Export Limitations",{"path":1715,"title":1716},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-static-export-vs-astro-for-marketing-sites","Next.js Static Export vs Astro for Marketing",{"path":1718,"title":1719},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Foptimizing-images-in-nextjs-static-export","Optimizing Images in Next.js Static Export",{"path":1721,"title":1722},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fadding-pagefind-to-an-astro-site","Adding Pagefind to an Astro Site",{"path":1724,"title":1725},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fbuilding-a-lunr-index-at-build-time-in-eleventy","Building a Lunr Index at Build Time in Eleventy",{"path":1727,"title":1728},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites","Search for Static Sites",{"path":1730,"title":1731},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Findexing-hugo-sites-with-pagefind","Indexing Hugo Sites with Pagefind",{"path":1733,"title":1734},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fmultilingual-search-on-static-sites","Multilingual Search on Static Sites",{"path":1736,"title":1737},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fpagefind-vs-algolia-docsearch","Pagefind vs Algolia DocSearch",{"path":1739,"title":1466},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fsearch-index-size-budgets-for-large-docs",{"path":1741,"title":1742},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fbest-ssg-for-technical-writers-without-coding-experience","Best SSG for Non-Developer Technical Writers",{"path":1744,"title":1539},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fchoosing-an-ssg-for-api-reference-documentation",{"path":1746,"title":1747},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fevaluating-ssg-accessibility-defaults","Evaluating SSG Accessibility Defaults",{"path":1749,"title":1750},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix","SSG Framework Selection Matrix",{"path":1752,"title":1753},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fpicking-an-ssg-for-a-multi-language-documentation-site","Picking an SSG for a Multi-Language Docs Site",{"path":1755,"title":1756},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fssg-selection-checklist-for-engineering-teams","SSG Selection Checklist for Engineering Teams",{"path":1758,"title":1759},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Ftotal-cost-of-ownership-for-static-site-generators","Total Cost of Ownership for Static Site Generators",{"path":1761,"title":1762},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-busting-with-content-hashed-filenames","Cache Busting with Content-Hashed Filenames",{"path":1764,"title":1765},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs","CDN Caching Rules for SSGs",{"path":1767,"title":1768},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fpurging-the-cdn-cache-after-a-static-deploy","Purging the CDN Cache After a Static Deploy",{"path":1770,"title":1771},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-cache-control-headers-on-cloudflare-pages","Cache-Control Headers on Cloudflare Pages",{"path":1773,"title":1774},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-up-proper-cache-headers-on-netlify","Proper Cache Headers on Netlify for SSGs",{"path":1776,"title":1777},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fstale-while-revalidate-for-static-html","Stale-While-Revalidate for Static HTML",{"path":1779,"title":1780},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Feliminating-layout-shift-from-web-fonts","Eliminating Layout Shift From Web Fonts",{"path":1782,"title":1783},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-cookie-banners","Fixing CLS from Cookie Banners",{"path":1785,"title":1786},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-late-loading-embeds","Fixing CLS From Late-Loading Embeds",{"path":1788,"title":1789},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-sticky-headers-and-anchor-links","Fixing CLS from Sticky Headers and Anchor Links",{"path":1791,"title":1792},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites","Cumulative Layout Shift Fixes for Static Sites",{"path":1794,"title":1795},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Fmeasuring-cls-in-the-field-with-web-vitals-js","Measuring CLS in the Field With web-vitals.js",{"path":1797,"title":1798},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Freserving-space-for-images-and-embeds-to-stop-layout-shift","Reserving Space for Images and Embeds",{"path":1800,"title":1801},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Ffont-display-optional-vs-swap","font-display: optional vs swap",{"path":1803,"title":1804},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites","Font Loading Strategies for Static Sites",{"path":1806,"title":1807},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fmetric-matched-fallback-fonts-with-size-adjust","Metric-Matched Fallback Fonts with size-adjust",{"path":1809,"title":1810},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fpreloading-fonts-without-double-downloads","Preloading Fonts Without Double Downloads",{"path":1812,"title":1813},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fself-hosting-google-fonts-to-eliminate-layout-shift","Self-Host Google Fonts to Eliminate Layout Shift",{"path":1815,"title":1816},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fsubsetting-variable-fonts-for-faster-first-render","Subsetting Variable Fonts for Faster First Render",{"path":1818,"title":1819},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fbuilding-an-image-cdn-pipeline-for-static-sites","Building an Image CDN Pipeline for Static Sites",{"path":1821,"title":1822},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fgenerating-open-graph-images-at-build-time","Generating Open Graph Images at Build Time",{"path":1824,"title":1825},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro","Image Optimization Pipelines in Astro",{"path":1827,"title":1828},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Flazy-loading-images-without-hurting-lcp","Lazy-Loading Images Without Hurting LCP",{"path":1830,"title":1831},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Foptimizing-webp-images-in-hugo-without-plugins","Optimizing WebP Images in Hugo Without Plugins",{"path":1833,"title":1834},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fresponsive-images-with-srcset-in-eleventy","Responsive Images with srcset in Eleventy",{"path":1836,"title":1837},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fserving-avif-with-fallbacks-on-static-sites","Serving AVIF With Fallbacks on Static Sites",{"path":1839,"title":1840},"\u002Fperformance-optimization-core-web-vitals-for-ssgs","Core Web Vitals Optimization for SSGs",{"path":1842,"title":1843},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fastro-islands-vs-full-hydration-performance","Astro Islands vs Full Hydration Performance",{"path":1845,"title":1846},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fdeferring-hydration-with-client-visible-in-astro","Deferring Hydration with client:visible in Astro",{"path":1848,"title":1849},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fhow-to-reduce-bundle-size-in-eleventy-builds","How to Reduce Bundle Size in Eleventy Builds",{"path":1851,"title":1852},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering","JavaScript Hydration & Partial Rendering",{"path":1854,"title":1855},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fmeasuring-inp-on-static-sites-with-real-user-monitoring","Measuring INP on Static Sites with RUM",{"path":1857,"title":1858},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Freplacing-react-islands-with-web-components","Replacing React Islands with Web Components",{"path":1860,"title":1861},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Feliminating-render-blocking-css-on-static-sites","Eliminating Render-Blocking CSS on Static Sites",{"path":1863,"title":1864},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-lcp-on-text-heavy-documentation-pages","Fixing LCP on Text-Heavy Documentation Pages",{"path":1866,"title":1867},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites","Largest Contentful Paint Optimization for Static Sites",{"path":1869,"title":1870},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Fmeasuring-lcp-subparts-with-devtools","Measuring LCP Subparts with DevTools",{"path":1872,"title":1873},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Foptimizing-lcp-on-astro-with-priority-hints","Optimizing LCP on Astro with Priority Hints",{"path":1875,"title":1876},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Freducing-lcp-from-hero-images-on-static-sites","Reducing LCP from Hero Images on Static Sites",{"path":1878,"title":1879},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fcomparing-lab-and-field-data-with-crux","Comparing Lab and Field Data with CrUX",{"path":1881,"title":1882},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci","Performance Budgets and Lighthouse CI",{"path":1884,"title":1885},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Freducing-lighthouse-score-variance-in-ci","Reducing Lighthouse Score Variance in CI",{"path":1887,"title":1888},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Frunning-webpagetest-scripts-against-preview-deploys","Running WebPageTest Scripts Against Preview Deploys",{"path":1890,"title":1891},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fsetting-up-lighthouse-ci-for-a-static-site","Setting Up Lighthouse CI for a Static Site",{"path":1893,"title":1894},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Ftracking-bundle-size-per-pull-request","Tracking Bundle Size per Pull Request",{"path":1896,"title":1897},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fwriting-a-performance-budget-that-fails-builds","Writing a Performance Budget That Fails Builds",{"path":1899,"title":1900},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fauditing-unused-preloads","Auditing Unused Preloads",{"path":1902,"title":1903},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed","Resource Hints and Navigation Speed",{"path":1905,"title":1553},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Finstant-navigation-with-speculation-rules",{"path":1907,"title":1908},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fpreconnect-vs-dns-prefetch-on-static-sites","Preconnect vs DNS-Prefetch on Static Sites",{"path":1910,"title":1911},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fprefetching-links-in-astro","Prefetching Links in Astro",{"path":1913,"title":1914},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fview-transitions-on-multi-page-static-sites","View Transitions on Multi-Page Static Sites",{"path":1916,"title":1917},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fauditing-third-party-scripts-with-lighthouse","Auditing Third-Party Scripts With Lighthouse",{"path":1919,"title":1920},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites","Third-Party Script Performance on Static Sites",{"path":1922,"title":1923},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Flazy-loading-youtube-embeds-on-static-sites","Lazy-Loading YouTube Embeds on Static Sites",{"path":1925,"title":1926},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Floading-google-tag-manager-without-hurting-inp","Loading Google Tag Manager Without Hurting INP",{"path":1928,"title":1929},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Frunning-third-party-scripts-in-a-web-worker-with-partytown","Running Third-Party Scripts in a Web Worker with Partytown",{"path":1931,"title":1932},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fself-hosting-analytics-to-cut-third-party-requests","Self-Hosting Analytics to Cut Third-Party Requests",{"path":1934,"title":1935},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fautomating-eleventy-deployments-with-cloudflare-pages","Automating Eleventy Deployments on Cloudflare Pages",{"path":1937,"title":1938},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fconfiguring-redirects-on-cloudflare-pages","Configuring Redirects on Cloudflare Pages",{"path":1940,"title":1941},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fcustom-domains-and-tls-on-cloudflare-pages","Custom Domains and TLS on Cloudflare Pages",{"path":1943,"title":1944},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fdeploying-hugo-to-cloudflare-pages-and-workers","Deploying Hugo to Cloudflare Pages and Workers",{"path":1946,"title":1947},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup","Cloudflare Pages Edge Caching Setup",{"path":1949,"title":1950},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fmigrating-from-cloudflare-pages-to-workers-static-assets","Migrating from Cloudflare Pages to Workers Static Assets",{"path":1952,"title":1953},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fchecking-links-in-pull-requests","Checking Links in Pull Requests",{"path":1955,"title":1956},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fdocs-as-code-review-workflow-for-writers","Docs-as-Code Review Workflow for Writers",{"path":1958,"title":1959},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci","Editorial Checks with Vale in CI",{"path":1961,"title":1962},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams","Content Workflows for Documentation Teams",{"path":1964,"title":1965},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fscheduling-content-publication-with-cron-triggered-builds","Scheduling Content Publication With Cron-Triggered Builds",{"path":1967,"title":1968},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fwiring-a-headless-cms-to-a-static-build","Wiring a Headless CMS to a Static Build",{"path":1970,"title":1971},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fbuilding-astro-sites-with-github-actions","Building Astro Sites with GitHub Actions",{"path":1973,"title":1974},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fcaching-node-modules-in-github-actions-for-faster-ssg-builds","Caching node_modules in GitHub Actions",{"path":1976,"title":1977},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-github-pages-with-actions","Deploying to GitHub Pages with Actions",{"path":1979,"title":1980},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-multiple-environments-from-one-workflow","Deploying to Multiple Environments From One Workflow",{"path":1982,"title":1983},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fhow-to-set-up-github-actions-for-hugo-deployments","GitHub Actions for Hugo Deployments",{"path":1985,"title":1986},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds","GitHub Actions for Automated SSG Builds",{"path":1988,"title":1110},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fmatrix-builds-for-multi-site-monorepos",{"path":1990,"title":1991},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fcaching-hugo-builds-in-github-actions","Caching Hugo Builds in GitHub Actions",{"path":1993,"title":1994},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fenabling-incremental-builds-in-eleventy","Enabling Incremental Builds in Eleventy",{"path":1996,"title":1997},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fincremental-builds-in-astro-with-the-content-layer","Incremental Builds in Astro with the Content Layer",{"path":1999,"title":2000},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs","Incremental Builds and Build Caching for SSGs",{"path":2002,"title":2003},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fmeasuring-build-time-regressions-in-ci","Measuring Build-Time Regressions in CI",{"path":2005,"title":2006},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fremote-caching-with-turborepo-for-ssg-monorepos","Remote Caching with Turborepo for SSG Monorepos",{"path":2008,"title":2009},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fsharing-build-cache-across-ci-runners","Sharing Build Cache Across CI Runners",{"path":2011,"title":2012},"\u002Fproduction-ready-deployment-cicd-workflows","Production-Ready Deployment & CI\u002FCD for SSGs",{"path":2014,"title":2015},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Falerting-on-cache-hit-ratio-drops","Alerting on Cache Hit Ratio Drops",{"path":2017,"title":2018},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fbuilding-a-core-web-vitals-dashboard-from-rum-data","Building a Core Web Vitals Dashboard from RUM Data",{"path":2020,"title":2021},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fcrawling-for-broken-links-on-a-schedule","Crawling for Broken Links on a Schedule",{"path":2023,"title":2024},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production","Monitoring Static Sites in Production",{"path":2026,"title":2027},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Flogging-404s-at-the-edge","Logging 404s at the Edge",{"path":2029,"title":2030},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fuptime-and-synthetic-checks-for-static-sites","Uptime and Synthetic Checks for Static Sites",{"path":2032,"title":2033},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fconfiguring-vercel-for-hugo-and-eleventy","Configuring Vercel for Hugo and Eleventy",{"path":2035,"title":2036},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies","Netlify vs Vercel Deployment Strategies",{"path":2038,"title":2039},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-build-hooks-for-content-updates","Netlify Build Hooks for Content Updates",{"path":2041,"title":2042},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-redirects-and-rewrites-for-static-sites","Netlify Redirects and Rewrites for Static Sites",{"path":2044,"title":2045},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fsetting-up-deploy-previews-on-netlify-for-every-pull-request","Netlify Deploy Previews for Every Pull Request",{"path":2047,"title":2048},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fvercel-isr-vs-static-generation-for-ssgs","Vercel ISR vs Static Generation for SSGs",{"path":2050,"title":2051},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fautomating-preview-deploy-pipelines-with-github-actions","Automating Preview Deploy Pipelines with GitHub Actions",{"path":2053,"title":2054},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fcleaning-up-stale-preview-deployments","Cleaning Up Stale Preview Deployments",{"path":2056,"title":2057},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests","Preview Environments for Pull Requests",{"path":2059,"title":2060},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpassword-protecting-preview-deployments","Password-Protecting Preview Deployments",{"path":2062,"title":2063},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpreviewing-headless-cms-drafts","Previewing Headless CMS Drafts",{"path":2065,"title":2066},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fvisual-regression-testing-on-preview-deploys","Visual Regression Testing on Preview Deploys",{"path":2068,"title":1456},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fatomic-deploys-vs-incremental-uploads",{"path":2070,"title":2071},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fcanary-releases-for-static-sites","Canary Releases for Static Sites",{"path":2073,"title":2074},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Ffeature-flags-on-static-sites","Feature Flags on Static Sites",{"path":2076,"title":2077},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites","Rollbacks and Deploy Safety for Static Sites",{"path":2079,"title":2080},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frolling-back-a-bad-static-deploy-in-under-a-minute","Rolling Back a Bad Static Deploy in Under a Minute",{"path":2082,"title":2083},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frunning-smoke-tests-against-a-preview-url","Running Smoke Tests Against a Preview URL",{"path":2085,"title":2086},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fauditing-npm-dependencies-in-ssg-pipelines","Auditing npm Dependencies in SSG Pipelines",{"path":2088,"title":2089},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fenabling-hsts-and-preload-safely","Enabling HSTS and Preload Safely",{"path":2091,"title":2092},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fhash-based-csp-for-inline-scripts-in-astro","Hash-Based CSP for Inline Scripts in Astro",{"path":2094,"title":2095},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites","Security Headers and Hardening for Static Sites",{"path":2097,"title":2098},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecuring-deploy-credentials-with-github-oidc","Securing Deploy Credentials with GitHub OIDC",{"path":2100,"title":2101},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsubresource-integrity-for-third-party-assets","Subresource Integrity for Third-Party Assets",{"path":2103,"title":2104},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fwriting-a-content-security-policy-for-a-static-site","Writing a Content Security Policy for a Static Site",{"path":2106,"title":424},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fclean-urls-and-trailing-slashes-on-s3",{"path":2108,"title":2109},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fcloudfront-functions-for-redirects","CloudFront Functions for Redirects",{"path":2111,"title":2112},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fdeploying-a-static-site-to-s3-and-cloudfront","Deploying a Static Site to S3 and CloudFront",{"path":2114,"title":2115},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites","Self-Hosting Static Sites on S3, Nginx and Caddy",{"path":2117,"title":2118},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-caddy","Serving a Static Site with Caddy",{"path":2120,"title":2121},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-nginx","Serving a Static Site with Nginx",{"path":2123,"title":2124},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fzero-downtime-deploys-with-symlink-swaps","Zero-Downtime Deploys with Symlink Swaps",{"path":2126,"title":2127},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fadding-a-contact-form-with-cloudflare-workers","Adding a Contact Form with Cloudflare Workers",{"path":2129,"title":2130},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fhandling-form-submissions-on-a-static-site","Handling Form Submissions on a Static Site",{"path":2132,"title":2133},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites","Serverless Functions for Static Sites",{"path":2135,"title":2136},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fnetlify-functions-vs-cloudflare-workers","Netlify Functions vs Cloudflare Workers",{"path":2138,"title":2139},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fprotecting-a-static-site-behind-authentication","Protecting a Static Site Behind Authentication",{"path":2141,"title":2142},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fproxying-third-party-apis-from-an-edge-function","Proxying Third-Party APIs from an Edge Function",1789722847271]