Repolode
gatsbyjs

gatsbyjs/gatsby

A React-based framework for building fast websites and apps, pulling data from CMSs, Markdown and APIs through GraphQL.

Stars
55,937
Forks
10,102
Open issues
457
Last commit
17 hours ago

What is it?

Gatsby is a React framework for building websites and apps. It loads data from sources such as Markdown files, headless CMSs like Contentful or WordPress, and REST or GraphQL APIs through source plugins, then exposes all of it through a single GraphQL interface.

Rendering can be chosen per page among static site generation, deferred static generation, and server-side rendering. Gatsby also handles code splitting, image optimization, critical CSS inlining, lazy loading, and resource prefetching automatically. Because the output is a static build, sites can be hosted on a CDN without running a server.

The project is a Lerna monorepo that publishes its packages to npm, and it is distributed under the MIT license. New projects can be created with npm init gatsby, and starters are available for common site types.

Key features

  • 01Pulls data from Markdown, headless CMSs, and REST or GraphQL APIs via source plugins.
  • 02Exposes all data through a uniform GraphQL interface.
  • 03Supports static, deferred static, and server-side rendering per page.
  • 04Automates code splitting, image optimization, and lazy loading.
  • 05Builds to static output that can be hosted on a CDN.

Use cases

  • Building content-heavy blogs or marketing sites backed by a headless CMS.
  • Creating e-commerce storefronts or user dashboards that still need static performance.
  • Hosting a site on a CDN with minimal server cost.

Quick start

  1. 1

    Initialize a new project

    npm init gatsby
  2. 2

    Move into the new site directory and start develop mode

    cd my-gatsby-site/ npm run develop
  3. 3

    Open http://localhost:8000 and edit src/pages/index.js

Topics

FAQ

What is gatsby?
A React-based framework for building fast websites and apps, pulling data from CMSs, Markdown and APIs through GraphQL. Gatsby is a React framework for building websites and apps. It loads data from sources such as Markdown files, headless CMSs like Contentful or WordPress, and REST or GraphQL APIs through source plugins, then exposes all of it through a single GraphQL interface.
Is gatsby free to use? What license does it have?
gatsby is open source under the MIT license. Check the license terms before using it in commercial products.
Is gatsby still maintained?
Actively maintained. The last commit to gatsby was on Oct 20, 2026.
What can I use gatsby for?
Building content-heavy blogs or marketing sites backed by a headless CMS. Creating e-commerce storefronts or user dashboards that still need static performance. Hosting a site on a CDN with minimal server cost.
How do I install gatsby?
Initialize a new project: npm init gatsby Move into the new site directory and start develop mode: cd my-gatsby-site/ npm run develop Open http://localhost:8000 and edit src/pages/index.js
Where can I get gatsby?
The source code and installation instructions are on GitHub: https://github.com/gatsbyjs/gatsby

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects