55,916
stars
+-1
10,082
forks
685
watchers
22,686
prs
14,129
issues
158
releases
2,368
discussions
README
Gatsby
The future of web development is here.
Gatsby is a free and open-source framework based on React that helps developers build blazing fast websites and apps. It combines the control and scalability of dynamically rendered sites with the speed of static-site generation, creating a whole new web of possibilities.
Quickstart
·
Tutorial
·
Plugins
·
Starters
·
Showcase
·
Contribute
Support: Discussions
Gatsby helps professional developers efficiently create maintainable, highly-performant, content-rich websites.
- Load Data From Anywhere. Gatsby pulls in data from any data source, whether it’s Markdown files, a headless CMS like Contentful or WordPress, or a REST or GraphQL API. Use source plugins to load your data, then develop using Gatsby’s uniform GraphQL interface.
- Go Beyond Static Websites. Get all the benefits of static websites with none of the limitations. Gatsby sites are fully functional React apps, so you can create high-quality, dynamic web apps, from blogs to e-commerce sites to user dashboards.
- Choose your Rendering Options. You can choose alternative rendering options, namely Deferred Static Generation (DSG) and Server-Side Rendering (SSR), in addition to Static Site Generation (SSG) — on a per-page basis. This type of granular control allows you to optimize for performance and productivity without sacrificing one for the other.
- Performance Is Baked In. Ace your performance audits by default. Gatsby automates code splitting, image optimization, inlining critical styles, lazy-loading, prefetching resources, and more to ensure your site is fast — no manual tuning required.
- Use a Modern Stack for Every Site. No matter where the data comes from, Gatsby sites are built using React and GraphQL. Build a uniform workflow for you and your team, regardless of whether the data is coming from the same backend.
- Host at Scale for Pennies. Gatsby sites don’t require servers, so you can host your entire site on a CDN for a fraction of the cost of a server-rendered site. Many Gatsby sites can be hosted entirely free on Netlify and other similar services.
Learn how to use Gatsby for your next project.
🚀 Ship your first Gatsby site in 5 Minutes
Click the link below to quickly try the workflow of developing, building, and deploying websites with Gatsby and Netlify.
At the end of this process, you'll have
1. a site working on Netlify
2. a new repository that is linked to that new site
3. as you push changes to your new repository, Netlify will automatically rebuild and redeploy your site!
💻 Get started with Gatsby locally in 5 Minutes
You can get a new Gatsby site up and running on your local dev environment in 5 minutes with these four steps:
1. Initialize a new project.
shell
npm init gatsby
Give it the name "My Gatsby Site".
2. Start the site in develop mode.
Next, move intoTop issues
#34051Build stuck at running jobs (image transformation)75 comments · 2021-11-22#38696Is Gatsby discontinued? Please upvote for clarification.53 comments · 2023-11-11#16076SecurityError: The operation is insecure in Firefox Developer edition41 comments · 2019-07-25#36899Heap memory usage increase during development builds after upgrading to v4.24.539 comments · 2022-10-27#38634GraphiQL White Screen of Death on Gatsby V5.11.038 comments · 2023-10-13#31385CTF-v6: ☂️ Umbrella issue for next major version of gatsby-source-contentful34 comments · 2021-05-12#35756[gatsby-transformer-javascript-frontmatter] Frontmatter export breaks HMR30 comments · 2022-05-25#32142Page 404 not rendering react when using pathPrefix and redirect26 comments · 2021-06-28
Discussions
#39699Is @proxy intended as a source-node or GraphQL alias?1 comments · 2026-10-13#39669Overview of Gatsby tests0 comments · 2026-08-28#39647Documentation comparing math plugins0 comments · 2026-08-16#39579Best practice for `npm install --ignore-scripts` with Gatsby and `sharp`2 comments · 2026-05-21#39506Automated accessibility testing for Gatsby sites0 comments · 2026-03-18#39478Updating Gatsby dependencies for security reasons1 comments · 2026-03-10#39447adding a gatsby-plugin-markdown-output (not for ingesting markdown, but for outputting markdown)1 comments · 2026-02-19#39418[Documentation] Add Hostinger deployment guide0 comments · 2026-02-03
Latest release
[email protected] [email protected] 2026-02-10What's Changed - Fix various regressions with Gatsby Head API, such as not updating document.title by @serhalp and @pieh in https://github.com/gatsbyjs/gatsby/pull/39382 Full Changelog: https://github.com/gatsbyjs/gatsby/compare/[email protected]@5.16.1