Gatsby → Astro
mediumGatsby is effectively dead (Netlify acquisition, no updates). Astro is the modern content-first framework with island architecture.
npm create astro@latest
Copy markdown/MDX files. Astro content collections replace Gatsby's GraphQL data layer. Define collection schema in src/content/config.ts.
Gatsby JSX pages → Astro .astro files. Replace gatsby-link with <a> tags. Remove GraphQL queries.
gatsby-plugin-image → Astro Image. gatsby-plugin-mdx → built-in MDX. gatsby-source-* → Astro content loaders or fetch().
Keep React components with client:load or client:visible directives for interactive parts.
npm install @astrojs/react
What this migration involves
Moving from Gatsby to Astro is rated medium and takes about 4-10h on a typical project. The guide breaks it into 6 steps, 2 of which ship with runnable commands and 1 with a verification check.
Related migrations
FAQ
How long does migrating from Gatsby to Astro take?
Around 4-10h for a typical project — 6 steps, difficulty rated medium, 2 of them with copy-paste commands.
Is moving from Gatsby to Astro reversible?
No reverse guide is tracked yet, so treat this as a one-way move and keep a full export of your Gatsby data before you start.
What does Astro cost compared to Gatsby?
Astro: open-source from $0/mo, free plan available.