Gatsby

Gatsby built a large share of the React content sites still running today, and most guides here are written for the teams who maintain one. The question they face is rarely which generator is best in general; it is whether to stay, and if not, where to go and how to get there without breaking URLs or losing search traffic.

Two comparisons measure the realistic destinations on real sites — Astro with React islands, and Next.js static export for teams that want React-first pages — on build time, JavaScript shipped, field Core Web Vitals and dependency health. The migration guides then cover the hard part, which is not the components but Gatsby's GraphQL data layer, and the SEO checks that keep a migration from costing rankings.

Destinations for an existing Gatsby site The root asks what the site needs most. Mostly content goes to Astro with React islands. React-first pages go to Next.js static export. A site retiring soon stays on Gatsby with audited dependencies. Where Gatsby sites usually go next What does the Gatsby site need most? Mostly content Astro + islands least JavaScript React-first pages Next.js export components unchanged Retiring soon Stay for now audit dependencies
The comparisons below measure the first two branches on real sites.

Choosing the Right Static Site Generator for Production

Number of Gatsby guides of each kind Vertical bars: How-tos 3, Fixes 0, Comparisons 2 and Concepts 0. Gatsby guides by kind 3 How-tos 0 Fixes 2 Comparisons 0 Concepts
5 guides use Gatsby in depth; each is listed below under the section it belongs to.
Topics with the most Gatsby guides Horizontal bars, largest first: Migrating Between Static Site Generators 2, Next.js Static Export for Content Sites 2 and SSG Framework Selection Matrix 1. Where Gatsby comes up Migrating Between Static Site Generators 2 Next.js Static Export for Content Sites 2 SSG Framework Selection Matrix 1
Topic pages give the wider context for each group; the numbers count only guides that use this tool in depth.

Often used with Gatsby

  • Astro2 shared guidesIslands, content collections, astro:assets and deployment.
  • Next.js2 shared guidesStatic export for content sites, its limits and alternatives.