Comparisons

Comparisons are where static site advice is weakest elsewhere: feature tables copied from project homepages, benchmarks on a hello-world site, conclusions that were decided before the test. The comparisons here are run on the same real content for every option — the same 2,000-page documentation corpus for the docs frameworks, the same 10,000 pages for Astro against Eleventy — on the same machine, with the method written down so it can be reproduced.

Many end without a single winner, because the honest answer depends on the site: Hugo builds fastest, Astro ships the least JavaScript, Docusaurus has versioning built in. What each comparison gives you is the criteria that decide it for your case, and the measured numbers to decide with.

Conditions every comparison on the site holds constant A matrix of four conditions and why each matters. Same content, because content shape changes results. Same hardware, because CPU and memory dominate build times. Same features enabled, such as search and highlighting. Several runs with medians, because single runs are noisy. What makes a comparison fair Held constant Why it matters How Content shape changes results same real corpus Hardware CPU and memory dominate same runner Features search and highlighting cost enabled in all Repetition single runs are noisy median of 5+
When a comparison cannot hold one of these constant, it says so next to the result.

Astro vs Eleventy for Documentation Sites

Number of comparisons per topic, largest first Horizontal bars. Astro vs Eleventy for Documentation Sites 6, Docs Frameworks: Docusaurus, Starlight and VitePress 4, Font Loading Strategies for Static Sites 3, Next.js Static Export for Content Sites 2, Search for Static Sites 2, JavaScript Hydration & Partial Rendering 2, Performance Budgets and Lighthouse CI 2 and Netlify vs Vercel Deployment Strategies 2. Topics with the most comparisons Astro vs Eleventy for Documentation… 6 Docs Frameworks: Docusaurus, Starlight… 4 Font Loading Strategies 3 Next.js Static Export for Content Sites 2 Search 2 JavaScript Hydration & Partial Rendering 2 Performance Budgets and Lighthouse CI 2 Netlify vs Vercel Deployment Strategies 2
The 8 topics with the most comparisons, out of 20 topics that have any.

Docs Frameworks: Docusaurus, Starlight and VitePress

Internationalization for Static Sites

Jekyll Plugin Ecosystem

  • Eleventy vs Jekyll for Markdown-Heavy BlogsFor thousands of Markdown files, compare Eleventy and Jekyll on parser config, data cascade, incremental-build reliability, and real build numbers from a 5,000-post corpus.

Next.js Static Export for Content Sites

Search for Static Sites

  • Pagefind vs Algolia DocSearchBuild-time Pagefind against hosted Algolia DocSearch on one 2,000-page docs site: relevance, latency, freshness, analytics, privacy and total cost.
  • Pagefind vs Lunr for Small Documentation SitesPagefind and Lunr compared on a 150-page docs site: index size, first-query time, relevance, setup effort and maintenance, with the crossover point measured.

SSG Framework Selection Matrix

CDN Caching Rules for SSGs

CSS and JavaScript Asset Optimization

  • SVG Icon Sprites vs Inline IconsReplace icon fonts on a static site with inline SVG or an external sprite, compare bytes, requests and paint timing, and build the sprite at build time.

Font Loading Strategies for Static Sites

  • Self-Hosted Fonts vs Google Fonts for Static SitesSelf-hosted fonts and Google Fonts measured on the same static site: connections, LCP, CLS, caching, privacy and maintenance, and when each wins.
  • Variable Fonts vs Static WeightsDecide between one variable font file and several static weights on a static site: bytes per weight count, subsetting, axis ranges, rendering and caching.
  • font-display: optional vs swapfont-display swap always shows your web font but can shift layout; optional never shifts but may skip the font. How to choose per font on a static site.

JavaScript Hydration & Partial Rendering

  • Astro Islands vs Full Hydration PerformanceMeasured comparison of Astro islands against full SPA hydration — JavaScript bytes, Total Blocking Time, and INP numbers, plus which directive to reach for.
  • Preact vs React Islands Bundle SizeMeasure React against Preact for Astro islands: runtime size, hydration time, compatibility gaps with preact/compat, and when switching is worth the effort.
Number of comparisons in each section Vertical bars: Framework selection 17, Performance 11 and Deployment 7. As a share of all guides in the section: Framework selection 14%, Performance 11%, Deployment 6%. Comparisons in each section 17 Framework selection 11 Performance 7 Deployment
35 comparisons in total. As a share of each section: framework selection 14%, performance 11%, deployment 6%.

Performance Budgets and Lighthouse CI

Resource Hints and Navigation Speed

Third-Party Script Performance on Static Sites

Content Workflows for Documentation Teams

Incremental Builds and Build Caching for SSGs

Netlify vs Vercel Deployment Strategies

Rollbacks and Deploy Safety for Static Sites

  • Atomic Deploys vs Incremental UploadsWhy syncing files into a live bucket serves broken pages, how atomic publishing works, and how to build atomicity yourself on S3, object storage or a VM origin.

Self-Hosting Static Sites on S3, Nginx and Caddy

  • Nginx vs Caddy for Serving Static SitesNginx and Caddy compared serving the same static site: throughput, latency, memory, TLS automation, config size, compression and the mistakes each one invites.

Serverless Functions for Static Sites

Other kinds of guide

  • How-tosA task, end to end, with configuration and measured results.
  • FixesStarts from a symptom and ends at the cause and the fix.
  • ConceptsExplains how something works and when it matters.