# gatsby

> Blazing fast modern site generator for React

Latest version **5.16.1** (published 2026-02-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install gatsby
pnpm add gatsby
yarn add gatsby
bun add gatsby
```

Provides the command `gatsby`.

## Health

**Score 70/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high maintenance score; popular repo; extremely popular.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 5.16.1 |
| Published | 2026-02-10 |
| First published | 2015-05-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.0.0 <26 |
| Dependencies | 167 |
| Unpacked size | 6.7 MB |
| Known vulnerabilities | 0 (+5 in 4 direct dependencies) |
| Install scripts | yes |
| GitHub stars | 55942 |
| Author | Kyle Mathews |
| Maintainers | pieh, kathmbeck, serhalp-netlify, mlgualtieri-gatsby, fk, tylerbarnes, daniellewgatsby |
| Keywords | blog, generator, jekyll, markdown, react, ssg, website |

## Links

- npm: https://www.npmjs.com/package/gatsby
- Repository: https://github.com/gatsbyjs/gatsby
- Homepage: https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby#readme
- Issues: https://github.com/gatsbyjs/gatsby/issues
- npm.io page: https://npm.io/package/gatsby

## Dependencies (167)

- [got](https://npm.io/package/got.md) ^11.8.6
- [joi](https://npm.io/package/joi.md) ^17.9.2
- [tmp](https://npm.io/package/tmp.md) ^0.2.1
- [cors](https://npm.io/package/cors.md) ^2.8.5
- [glob](https://npm.io/package/glob.md) ^7.2.3
- [lmdb](https://npm.io/package/lmdb.md) 2.5.3
- [mime](https://npm.io/package/mime.md) ^3.0.0
- [mitt](https://npm.io/package/mitt.md) ^1.2.0
- [uuid](https://npm.io/package/uuid.md) ^8.3.2
- [anser](https://npm.io/package/anser.md) ^2.1.1
- [axios](https://npm.io/package/axios.md) ^1.6.4
- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [debug](https://npm.io/package/debug.md) ^4.3.4
- [execa](https://npm.io/package/execa.md) ^5.1.1
- [fastq](https://npm.io/package/fastq.md) ^1.15.0
- [hasha](https://npm.io/package/hasha.md) ^5.2.2
- [meant](https://npm.io/package/meant.md) ^1.0.3
- [redux](https://npm.io/package/redux.md) 4.2.1
- [cookie](https://npm.io/package/cookie.md) ^0.5.0
- [dotenv](https://npm.io/package/dotenv.md) ^8.6.0
- [eslint](https://npm.io/package/eslint.md) ^7.32.0
- [globby](https://npm.io/package/globby.md) ^11.1.0
- [linkfs](https://npm.io/package/linkfs.md) ^2.1.0
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [moment](https://npm.io/package/moment.md) ^2.29.4
- [multer](https://npm.io/package/multer.md) ^2.0.1
- [semver](https://npm.io/package/semver.md) ^7.5.3
- [xstate](https://npm.io/package/xstate.md) ^4.38.0
- [address](https://npm.io/package/address.md) 1.2.2
- [core-js](https://npm.io/package/core-js.md) ^3.31.0
- [express](https://npm.io/package/express.md) ^4.18.2
- [graphql](https://npm.io/package/graphql.md) ^16.7.1
- [p-defer](https://npm.io/package/p-defer.md) ^3.0.0
- [postcss](https://npm.io/package/postcss.md) ^8.4.24
- [prompts](https://npm.io/package/prompts.md) ^2.4.2
- [slugify](https://npm.io/package/slugify.md) ^1.6.6
- [type-of](https://npm.io/package/type-of.md) ^2.0.1
- [webpack](https://npm.io/package/webpack.md) ~5.98.0
- [bluebird](https://npm.io/package/bluebird.md) ^3.7.2
- [chokidar](https://npm.io/package/chokidar.md) ^3.6.0
- [date-fns](https://npm.io/package/date-fns.md) ^2.30.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.2.0
- [memoizee](https://npm.io/package/memoizee.md) ^0.4.15
- [parseurl](https://npm.io/package/parseurl.md) ^1.3.3
- [platform](https://npm.io/package/platform.md) ^1.3.6
- [deepmerge](https://npm.io/package/deepmerge.md) ^4.3.1
- [invariant](https://npm.io/package/invariant.md) ^2.2.4
- [socket.io](https://npm.io/package/socket.io.md) ^4.8.1
- [acorn-walk](https://npm.io/package/acorn-walk.md) ^8.2.0
- [better-opn](https://npm.io/package/better-opn.md) ^2.1.1
- [css-loader](https://npm.io/package/css-loader.md) ^5.2.7
- [css.escape](https://npm.io/package/css.escape.md) ^1.5.1
- [gatsby-cli](https://npm.io/package/gatsby-cli.md) ^5.16.0
- [micromatch](https://npm.io/package/micromatch.md) ^4.0.5
- [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.11
- [prop-types](https://npm.io/package/prop-types.md) ^15.8.1
- [raw-loader](https://npm.io/package/raw-loader.md) ^4.0.2
- [strip-ansi](https://npm.io/package/strip-ansi.md) ^6.0.1
- [url-loader](https://npm.io/package/url-loader.md) ^4.1.1
- [@babel/core](https://npm.io/package/@babel/core.md) ^7.20.12
- [acorn-loose](https://npm.io/package/acorn-loose.md) ^8.3.0
- [body-parser](https://npm.io/package/body-parser.md) ^2.2.2
- [common-tags](https://npm.io/package/common-tags.md) ^1.8.2
- [compression](https://npm.io/package/compression.md) ^1.7.4
- [detect-port](https://npm.io/package/detect-port.md) ^1.5.1
- [file-loader](https://npm.io/package/file-loader.md) ^6.2.0
- [gatsby-link](https://npm.io/package/gatsby-link.md) ^5.16.0
- [graphql-tag](https://npm.io/package/graphql-tag.md) ^2.12.6
- [is-relative](https://npm.io/package/is-relative.md) ^1.0.0
- [json-loader](https://npm.io/package/json-loader.md) ^0.5.7
- [null-loader](https://npm.io/package/null-loader.md) ^4.0.1
- [opentracing](https://npm.io/package/opentracing.md) ^0.14.7
- [redux-thunk](https://npm.io/package/redux-thunk.md) ^2.4.2
- [signal-exit](https://npm.io/package/signal-exit.md) ^3.0.7
- [stack-trace](https://npm.io/package/stack-trace.md) ^0.0.10
- [yaml-loader](https://npm.io/package/yaml-loader.md) ^0.8.0
- [@babel/types](https://npm.io/package/@babel/types.md) ^7.20.7
- [@parcel/core](https://npm.io/package/@parcel/core.md) 2.8.3
- [autoprefixer](https://npm.io/package/autoprefixer.md) ^10.4.14
- [babel-loader](https://npm.io/package/babel-loader.md) ^8.3.0
- [browserslist](https://npm.io/package/browserslist.md) ^4.21.9
- [gatsby-sharp](https://npm.io/package/gatsby-sharp.md) ^1.16.0
- [graphql-http](https://npm.io/package/graphql-http.md) ^1.19.0
- [query-string](https://npm.io/package/query-string.md) ^6.14.1
- [resolve-from](https://npm.io/package/resolve-from.md) ^5.0.0
- [style-loader](https://npm.io/package/style-loader.md) ^2.0.0
- [@babel/parser](https://npm.io/package/@babel/parser.md) ^7.20.13
- [@expo/devcert](https://npm.io/package/@expo/devcert.md) ^1.2.0
- [@parcel/cache](https://npm.io/package/@parcel/cache.md) 2.8.3
- [cache-manager](https://npm.io/package/cache-manager.md) ^2.11.1
- [gatsby-script](https://npm.io/package/gatsby-script.md) ^2.16.0
- [gatsby-worker](https://npm.io/package/gatsby-worker.md) ^2.16.0
- [react-refresh](https://npm.io/package/react-refresh.md) ^0.14.1
- [webpack-merge](https://npm.io/package/webpack-merge.md) ^5.9.0
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.20.13
- [find-cache-dir](https://npm.io/package/find-cache-dir.md) ^3.3.2
- [latest-version](https://npm.io/package/latest-version.md) ^7.0.0
- [normalize-path](https://npm.io/package/normalize-path.md) ^3.0.0
- [path-to-regexp](https://npm.io/package/path-to-regexp.md) 0.1.12
- [postcss-loader](https://npm.io/package/postcss-loader.md) ^5.3.0
- [true-case-path](https://npm.io/package/true-case-path.md) ^2.2.1
- [@babel/traverse](https://npm.io/package/@babel/traverse.md) ^7.20.13
- [babel-jsx-utils](https://npm.io/package/babel-jsx-utils.md) ^1.1.0
- [graphql-compose](https://npm.io/package/graphql-compose.md) ^9.0.10
- [is-relative-url](https://npm.io/package/is-relative-url.md) ^3.0.0
- [react-dev-utils](https://npm.io/package/react-dev-utils.md) ^12.0.1
- [shallow-compare](https://npm.io/package/shallow-compare.md) ^1.2.2
- [style-to-object](https://npm.io/package/style-to-object.md) ^0.4.1
- [@nodelib/fs.walk](https://npm.io/package/@nodelib/fs.walk.md) ^1.2.8
- [enhanced-resolve](https://npm.io/package/enhanced-resolve.md) ^5.15.0
- [fs-exists-cached](https://npm.io/package/fs-exists-cached.md) 1.0.0
- [node-html-parser](https://npm.io/package/node-html-parser.md) ^5.4.2
- [socket.io-client](https://npm.io/package/socket.io-client.md) ^4.8.1
- [@babel/code-frame](https://npm.io/package/@babel/code-frame.md) ^7.18.6
- [@types/http-proxy](https://npm.io/package/@types/http-proxy.md) ^1.17.11
- [gatsby-core-utils](https://npm.io/package/gatsby-core-utils.md) ^4.16.0
- [gatsby-page-utils](https://npm.io/package/gatsby-page-utils.md) ^3.16.0
- [string-similarity](https://npm.io/package/string-similarity.md) ^1.2.2
- [error-stack-parser](https://npm.io/package/error-stack-parser.md) ^2.1.4
- [express-http-proxy](https://npm.io/package/express-http-proxy.md) ^1.6.3
- [physical-cpu-count](https://npm.io/package/physical-cpu-count.md) ^2.0.0
- [@graphql-tools/load](https://npm.io/package/@graphql-tools/load.md) ^7.8.14
- [babel-preset-gatsby](https://npm.io/package/babel-preset-gatsby.md) ^3.16.0
- [eslint-plugin-react](https://npm.io/package/eslint-plugin-react.md) ^7.32.2
- [fastest-levenshtein](https://npm.io/package/fastest-levenshtein.md) ^1.0.16
- [gatsby-plugin-utils](https://npm.io/package/gatsby-plugin-utils.md) ^4.16.0
- [@babel/eslint-parser](https://npm.io/package/@babel/eslint-parser.md) ^7.19.1
- [@graphql-codegen/add](https://npm.io/package/@graphql-codegen/add.md) ^3.2.3
- [eslint-plugin-import](https://npm.io/package/eslint-plugin-import.md) ^2.27.5
- [gatsby-parcel-config](https://npm.io/package/gatsby-parcel-config.md) 1.16.0
- [webpack-stats-plugin](https://npm.io/package/webpack-stats-plugin.md) ^1.1.3
- [@builder.io/partytown](https://npm.io/package/@builder.io/partytown.md) ^0.7.5
- [@graphql-codegen/core](https://npm.io/package/@graphql-codegen/core.md) ^2.6.8
- [eslint-webpack-plugin](https://npm.io/package/eslint-webpack-plugin.md) ^2.7.0
- [event-source-polyfill](https://npm.io/package/event-source-polyfill.md) 1.0.31
- [terser-webpack-plugin](https://npm.io/package/terser-webpack-plugin.md) ^5.3.9
- [@gatsbyjs/reach-router](https://npm.io/package/@gatsbyjs/reach-router.md) ^2.0.1
- [eslint-plugin-flowtype](https://npm.io/package/eslint-plugin-flowtype.md) ^5.10.0
- [eslint-plugin-jsx-a11y](https://npm.io/package/eslint-plugin-jsx-a11y.md) ^6.8.0
- [postcss-flexbugs-fixes](https://npm.io/package/postcss-flexbugs-fixes.md) ^5.0.2
- [webpack-dev-middleware](https://npm.io/package/webpack-dev-middleware.md) ^5.3.4
- [eslint-config-react-app](https://npm.io/package/eslint-config-react-app.md) ^6.0.0
- [gatsby-legacy-polyfills](https://npm.io/package/gatsby-legacy-polyfills.md) ^3.16.0
- [mini-css-extract-plugin](https://npm.io/package/mini-css-extract-plugin.md) 1.6.2
- [webpack-virtual-modules](https://npm.io/package/webpack-virtual-modules.md) ^0.6.2
- [gatsby-graphiql-explorer](https://npm.io/package/gatsby-graphiql-explorer.md) ^3.16.0
- [gatsby-plugin-typescript](https://npm.io/package/gatsby-plugin-typescript.md) ^5.16.0
- [react-server-dom-webpack](https://npm.io/package/react-server-dom-webpack.md) 0.0.0-experimental-c8b778b7f-20220825
- [@jridgewell/trace-mapping](https://npm.io/package/@jridgewell/trace-mapping.md) ^0.3.18
- [@typescript-eslint/parser](https://npm.io/package/@typescript-eslint/parser.md) ^5.60.1
- [eslint-plugin-react-hooks](https://npm.io/package/eslint-plugin-react-hooks.md) ^4.6.0
- [@babel/helper-plugin-utils](https://npm.io/package/@babel/helper-plugin-utils.md) ^7.20.2
- [gatsby-plugin-page-creator](https://npm.io/package/gatsby-plugin-page-creator.md) ^5.16.0
- [gatsby-react-router-scroll](https://npm.io/package/gatsby-react-router-scroll.md) ^6.16.0
- [@graphql-codegen/typescript](https://npm.io/package/@graphql-codegen/typescript.md) ^2.8.8
- [css-minimizer-webpack-plugin](https://npm.io/package/css-minimizer-webpack-plugin.md) ^2.0.0
- [@graphql-codegen/plugin-helpers](https://npm.io/package/@graphql-codegen/plugin-helpers.md) ^2.7.2
- [@graphql-tools/code-file-loader](https://npm.io/package/@graphql-tools/code-file-loader.md) ^7.3.23
- [babel-plugin-add-module-exports](https://npm.io/package/babel-plugin-add-module-exports.md) ^1.0.4
- [@gatsbyjs/webpack-hot-middleware](https://npm.io/package/@gatsbyjs/webpack-hot-middleware.md) ^2.25.3
- [@typescript-eslint/eslint-plugin](https://npm.io/package/@typescript-eslint/eslint-plugin.md) ^5.60.1
- [babel-plugin-dynamic-import-node](https://npm.io/package/babel-plugin-dynamic-import-node.md) ^2.3.3
- [@sigmacomputing/babel-plugin-lodash](https://npm.io/package/@sigmacomputing/babel-plugin-lodash.md) ^3.3.5
- [babel-plugin-remove-graphql-queries](https://npm.io/package/babel-plugin-remove-graphql-queries.md) ^5.16.0
- [@pmmmwh/react-refresh-webpack-plugin](https://npm.io/package/@pmmmwh/react-refresh-webpack-plugin.md) 0.5
- [@graphql-codegen/typescript-operations](https://npm.io/package/@graphql-codegen/typescript-operations.md) ^2.5.13
- [@vercel/webpack-asset-relocator-loader](https://npm.io/package/@vercel/webpack-asset-relocator-loader.md) 1.7.3

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 5.16.1 (latest) — 2026-02-10
- 5.17.0-next.1 (next) — 2025-12-22
- 5.18.0-react19.1 (react19) — 2025-11-26
- 5.15.0-prebuilt-libvips.6 (prebuilt-libvips) — 2025-06-20
- 5.11.1-canary-less-lmdb.0 (less-lmdb) — 2024-12-20
- 5.14.0-alpha-monorepo-support.17 (monorepo-support) — 2024-06-04
- 5.14.0-alpha-headers-perf.16 (headers-perf) — 2024-05-24
- 4.25.9 (latest-v4) — 2024-05-17
- 5.14.0-alpha-gatsby.9 (gatsby) — 2024-04-29
- 5.14.0-ctf-next.0 (ctf-next) — 2024-03-08
- 5.14.0-canary.7 (canary) — 2024-02-16
- 5.14.0-alpha-ssr-writestream.3 (ssr-writestream) — 2024-01-25
- 5.14.0-alpha-fix-parcel-segfault.11 (fix-parcel-segfault) — 2024-01-02
- 5.14.0-alpha-fix-ssr-linkfs.5 (alpha-fix-ssr-linkfs) — 2023-12-21
- 5.13.0-alpha-fix-pnpm.21 (alpha-fix-pnpm) — 2023-12-20
- … 2980 more at https://npm.io/package/gatsby/versions

## README

<p align="center">
  <a href="https://www.gatsbyjs.com">
    <img alt="Gatsby" src="https://www.gatsbyjs.com/Gatsby-Monogram.svg" width="60" />
  </a>
</p>
<h1 align="center">
  Gatsby
</h1>

<p align="center">
  <strong>
    The future of web development is here.
  </strong>
</p>
<p align="center">
  Gatsby is a free and open source framework based on React that helps developers build blazing fast websites and apps. </br> It combines the control and scalability of dynamically rendered sites with the speed of static-site generation, creating a whole new web of possibilities.
</p>
<p align="center">
  <a href="https://github.com/gatsbyjs/gatsby/blob/master/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Gatsby is released under the MIT license." />
  </a>
  <a href="https://circleci.com/gh/gatsbyjs/gatsby">
    <img src="https://circleci.com/gh/gatsbyjs/gatsby.svg?style=shield" alt="Current CircleCI build status." />
  </a>
  <a href="https://www.npmjs.com/package/gatsby">
    <img src="https://img.shields.io/npm/v/gatsby.svg" alt="Current npm package version." />
  </a>
  <a href="https://npmcharts.com/compare/gatsby?minimal=true">
    <img src="https://img.shields.io/npm/dm/gatsby.svg" alt="Downloads per month on npm." />
  </a>
  <a href="https://npmcharts.com/compare/gatsby?minimal=true">
    <img src="https://img.shields.io/npm/dt/gatsby.svg" alt="Total downloads on npm." />
  </a>
  <a href="https://gatsbyjs.com/contributing/how-to-contribute/">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome!" />
  </a>
</p>

<h2 align="center">
  <a href="https://www.gatsbyjs.com/docs/quick-start/">Quickstart</a>
  <span> · </span>
  <a href="https://www.gatsbyjs.com/docs/tutorial/getting-started/">Tutorial</a>
  <span> · </span>
  <a href="https://www.gatsbyjs.com/plugins/">Plugins</a>
  <span> · </span>
  <a href="https://www.gatsbyjs.com/starters/">Starters</a>
  <span> · </span>
  <a href="https://www.gatsbyjs.com/showcase/">Showcase</a>
  <span> · </span>
  <a href="https://www.gatsbyjs.com/contributing/how-to-contribute/">Contribute</a>
  <br />
  Support: <a href="https://github.com/gatsbyjs/gatsby/discussions">Discussions</a>
</h2>

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](https://gatsbyjs.com/docs/conceptual/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 [Gatsby Cloud](https://www.gatsbyjs.com/cloud/) and other similar services.

- **Use Gatsby's Centralized Data Layer Everywhere.** With Gatsby's [Valhalla Content Hub](https://www.gatsbyjs.com/products/valhalla-content-hub/) you can bring Gatsby's data layer to any project. Making it accessible via a unified GraphQL API for building content sites, eCommerce platforms, and both native and web applications.

[**Learn how to use Gatsby for your next project.**](https://www.gatsbyjs.com/docs/)

## 🚀 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 Gatsby Cloud.

[<img src="https://www.gatsbyjs.com/deploynow.svg" alt="Deploy to Gatsby Cloud">](https://www.gatsbyjs.com/dashboard/deploynow?url=https://github.com/gatsbyjs/gatsby-starter-blog&utm_source=github&utm_medium=link&utm_campaign=onboarding&utm_content=oss)

At the end of this process, you'll have

1. a site working on Gatsby Cloud
2. a new repository that is linked to that new site
3. as you push changes to your new repository, Gatsby Cloud 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 into your new site’s directory and start it up:

   ```shell
   cd my-gatsby-site/
   npm run develop
   ```

3. **Open the source code and start editing!**

   Your site is now running at `http://localhost:8000`. Open the `my-gatsby-site` directory in your code editor of choice and edit `src/pages/index.js`. Save your changes, and the browser will update in real time!

At this point, you’ve got a fully functional Gatsby website. For additional information on how you can customize your Gatsby site, see our [plugins](https://gatsbyjs.com/plugins/) and [the official tutorial](https://www.gatsbyjs.com/docs/tutorial/getting-started/).

## 🎓 Learning Gatsby

Full documentation for Gatsby lives [on the website](https://www.gatsbyjs.com/).

- **For most developers, we recommend starting with our [in-depth tutorial for creating a site with Gatsby](https://www.gatsbyjs.com/docs/tutorial/getting-started/).** It starts with zero assumptions about your level of ability and walks through every step of the process.

- **To dive straight into code samples head [to our documentation](https://www.gatsbyjs.com/docs/).** In particular, check out the “<i>How-to Guides</i>”, “<i>Reference</i>”, and “<i>Conceptual Guides</i>” sections in the sidebar.

We welcome suggestions for improving our docs. See the [“how to contribute”](https://www.gatsbyjs.com/contributing/how-to-contribute/) documentation for more details.

**Start Learning Gatsby: [Follow the Tutorial](https://www.gatsbyjs.com/docs/tutorial/getting-started/) · [Read the Docs](https://www.gatsbyjs.com/docs/)**

## 🚢 Release Notes

Wondering what we've shipped recently? Check out our [release notes](https://www.gatsbyjs.com/docs/reference/release-notes) for key highlights, performance improvements, new features, and notable bugfixes.

Also, read our [documentation on version support](https://www.gatsbyjs.com/docs/reference/release-notes/gatsby-version-support/) to understand our plans for each version of Gatsby.

## 💼 Migration Guides

Already have a Gatsby site? These handy guides will help you add the improvements of Gatsby v5 to your site without starting from scratch!

- [Migrate from v4 to v5](https://www.gatsbyjs.com/docs/reference/release-notes/migrating-from-v4-to-v5/)
- [Migrate from v3 to v4](https://www.gatsbyjs.com/docs/reference/release-notes/migrating-from-v3-to-v4/)
- [Migrate from v2 to v3](https://www.gatsbyjs.com/docs/reference/release-notes/migrating-from-v2-to-v3/)

## ❗ Code of Conduct

Gatsby is dedicated to building a welcoming, diverse, safe community. We expect everyone participating in the Gatsby community to abide by our [**Code of Conduct**](https://www.gatsbyjs.com/contributing/code-of-conduct/). Please read it. Please follow it. In the Gatsby community, we work hard to build each other up and create amazing things together. 💪💜

## 🤝 How to Contribute

Whether you're helping us fix bugs, improve the docs, or spread the word, we'd love to have you as part of the Gatsby community!

Check out our [**Contributing Guide**](https://www.gatsbyjs.com/contributing/how-to-contribute/) for ideas on contributing and setup steps for getting our repositories up and running on your local machine.

### A note on how this repository is organized

This repository is a [monorepo](https://trunkbaseddevelopment.com/monorepos/) managed using [Lerna](https://github.com/lerna/lerna). This means there are [multiple packages](https://github.com/gatsbyjs/gatsby/tree/master/packages) managed in this codebase, even though we publish them to NPM as separate packages.

## 📝 License

Licensed under the [MIT License](./LICENSE).

## 💜 Thanks

Thanks go out to all our many contributors creating plugins, starters, videos, and blog posts. And a special appreciation for our community members helping with issues and PRs, or answering questions on GitHub Discussions.

A big part of what makes Gatsby great is each and every one of you in the community. Your contributions enrich the Gatsby experience and make it better every day.

---
_Source: https://npm.io/package/gatsby · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
