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: Twitter, Discussions & Discord

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 Gatsby Cloud and other similar services.

• Use Gatsby's Centralized Data Layer Everywhere. With Gatsby's 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.

🚀 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.

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.

   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:

   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 and the official tutorial.

🎓 Learning Gatsby

Full documentation for Gatsby lives on the website.

• For most developers, we recommend starting with our in-depth tutorial for creating a site with Gatsby. 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. In particular, check out the “How-to Guides”, “Reference”, and “Conceptual Guides” sections in the sidebar.

We welcome suggestions for improving our docs. See the “how to contribute” documentation for more details.

Start Learning Gatsby: Follow the Tutorial · Read the Docs

🚢 Release Notes

Wondering what we've shipped recently? Check out our release notes for key highlights, performance improvements, new features, and notable bugfixes.

Also, read our documentation on 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
• Migrate from v3 to v4
• Migrate 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. 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 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 managed using Lerna. This means there are multiple packages managed in this codebase, even though we publish them to NPM as separate packages.

📝 License

Licensed under the MIT 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 Discord and 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.

Changelog: gatsby-remark-copy-linked-files

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

6.13.2 (2024-08-26)

Bug Fixes

• pin cheerio #39066 #39069 (282caaf)

6.13.1 (2024-01-23)

Note: Version bump only for package gatsby-remark-copy-linked-files

6.13.0 (2023-12-18)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.12.0 (2023-08-24)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.11.0 (2023-06-15)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.10.0 (2023-05-16)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.9.0 (2023-04-18)

🧾 Release notes

Bug Fixes

• update dependency fs-extra to ^11.1.1 #37827 (3e9a590)

6.8.0 (2023-03-21)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.7.0 (2023-02-21)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.6.0 (2023-02-07)

🧾 Release notes

Bug Fixes

• update babel monorepo #37568 (13a0a9e)

6.5.0 (2023-01-24)

🧾 Release notes

Chores

• Upgrade some non-breaking major versions #37406 (2ea80c0)

6.4.0 (2023-01-10)

🧾 Release notes

Chores

• update babel monorepo #37386 (b941876)

6.3.0 (2022-12-13)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.2.0 (2022-11-25)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.1.0 (2022-11-22)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

6.0.0 (2022-11-08)

🧾 Release notes

Chores

• Update peerDeps #36965 (b624442)
• apply patches for v5 #36796 (25f79b6)

5.24.0 (2022-09-27)

🧾 Release notes

Features

• Add absolutePath to dir function #36213 (f141c59)

5.23.0 (2022-09-13)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.22.0 (2022-08-30)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.21.0 (2022-08-16)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.20.0 (2022-08-02)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.19.0 (2022-07-19)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.18.0 (2022-07-05)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.17.0 (2022-06-21)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.16.0 (2022-06-07)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.15.0 (2022-05-24)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.14.0 (2022-05-10)

🧾 Release notes

Bug Fixes

• update dependency fs-extra to ^10.1.0 #34976 (10752ed)

5.13.0 (2022-04-26)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.12.1 (2022-04-13)

Note: Version bump only for package gatsby-remark-copy-linked-files

5.12.0 (2022-04-12)

🧾 Release notes

Bug Fixes

• update dependency probe-image-size to ^7.2.3 for gatsby-remark-copy-linked-files #35289 (5039ca0)

5.11.0 (2022-03-29)

🧾 Release notes

Chores

• replace all uses of gatsbyjs.org with gatsbyjs.com #35101 (16cff41)

5.10.0 (2022-03-16)

🧾 Release notes

Bug Fixes

• Upgrade probe-image-size to fix memory leak warning fix #35009 (f98c9ba)

5.9.0 (2022-03-01)

🧾 Release notes

Chores

• Format changelog files (088f23b)

5.8.0 (2022-02-22)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.7.0 (2022-02-08)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.6.0 (2022-01-25)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.5.0 (2022-01-11)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.4.0 (2021-12-14)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.3.0 (2021-12-01)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.2.0 (2021-11-16)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.1.0 (2021-11-02)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

5.0.0 (2021-10-21)

🧾 Release notes

Chores

• apply patches for v4 #33170 (f8c5141)

4.11.0 (2021-09-18)

🧾 Release notes

Chores

• update babel monorepo #32996 (048c7a7)
• update fs-extra (major) #32654 (eea2687)

4.10.0 (2021-09-01)

🧾 Release notes

Chores

• re-generate changelogs #32886 (417df15)

4.9.0 (2021-08-18)

🧾 Release notes

Bug Fixes

• update dependency cheerio to ^1.0.0-rc.10 for gatsby-remark-copy-linked-files #32577 (40eb226)

Chores

• update formatting & linting #32626 (4a765b5)
• update babel monorepo #32564 (a554998)

4.8.0 (2021-08-04)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

4.7.0 (2021-07-20)

🧾 Release notes

Chores

• update babel monorepo #32238 (466d4c0)

4.6.0 (2021-07-07)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

4.5.0 (2021-06-23)

🧾 Release notes

Bug Fixes

• replace checking parent node type to 'dir' #31780 (e854dcf)

Chores

• bump babel minor #31857 (7d42e8d)

4.4.1 (2021-06-10)

Chores

• bump babel minor #31857 #31859 (8636025)

4.4.0 (2021-06-09)

🧾 Release notes

Bug Fixes

• replace checking parent node type to 'dir' #31780 #31828 (34176c6)

Chores

• update babel monorepo #31143 (701ab2f)

4.3.0 (2021-05-25)

🧾 Release notes

Bug Fixes

• update cheerio snapshots #31298 (e06599d)

4.2.1 (2021-05-19)

Bug Fixes

• update cheerio snapshots #31298 #31483 (67a4fce)

4.2.0 (2021-05-12)

🧾 Release notes

Bug Fixes

• update minor and patch for gatsby-remark-copy-linked-files #31163 (2291fbd)

4.1.0 (2021-04-28)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

4.0.0 (2021-04-14)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

3.2.0 (2021-03-30)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

3.1.0 (2021-03-16)

🧾 Release notes

Bug Fixes

• update lodash monorepo to ^4.17.21 #29382 (9fd287b)

Chores

• update eslint to fix linting issues fix #29988 (5636389)

3.0.0 (2021-03-02)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

2.10.0 (2021-02-02)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

2.9.0 (2021-01-20)

🧾 Release notes

Bug Fixes

• update vulnerable packages, include React 17 in peerDeps #28545 (18b5f30)

2.8.0 (2021-01-06)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

2.7.0 (2020-12-15)

🧾 Release notes

Chores

• update dependency cross-env to ^7.0.3 #28505 (a819b9b)

2.6.0 (2020-12-02)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

2.5.0 (2020-11-20)

🧾 Release notes

Chores

• update babel monorepo #27528 (539dbb0)

2.4.0 (2020-11-12)

🧾 Release notes

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.19 (2020-10-06)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.18 (2020-10-01)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.17 (2020-09-28)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.16 (2020-09-23)

Bug Fixes

• gatsby-remark-copy-linked-files: respect assetPrefix (#26976) (6270c3d)

2.3.15 (2020-09-15)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.14 (2020-09-07)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.13 (2020-08-31)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.12 (2020-07-28)

Bug Fixes

• do not augment plugin-options (#26006) (222920b)

2.3.11 (2020-07-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.10 (2020-07-02)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.9 (2020-07-01)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.8 (2020-07-01)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.7 (2020-06-24)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.6 (2020-06-22)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.5 (2020-06-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.4 (2020-06-02)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.3 (2020-05-20)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.2 (2020-05-05)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.3.1 (2020-04-28)

Bug Fixes

• update packages (#23525) (e65dd1e)

2.3.0 (2020-04-27)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.2.4 (2020-04-24)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.2.3 (2020-04-17)

Bug Fixes

• wrap ignore pattern in quotes (#23176) (7563db6)

2.2.2 (2020-04-16)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.2.1 (2020-03-23)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.2.0 (2020-03-20)

Features

• gatsby: bump node min version to 10.13.0 (#22400) (83d681a)

2.1.40 (2020-03-16)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.39 (2020-03-09)

Features

• gatsby-remark-copy-linked-files: Add support for poster attribute in video elements (#22032) (70fd0eb)

2.1.38 (2020-03-06)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.37 (2020-02-01)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.36 (2020-01-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.35 (2020-01-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.34 (2020-01-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.33 (2019-12-10)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.32 (2019-12-10)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.31 (2019-11-26)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.30 (2019-11-15)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.29 (2019-11-10)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.28 (2019-10-14)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.27 (2019-10-14)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.26 (2019-10-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.25 (2019-10-08)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.24 (2019-10-04)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.23 (2019-09-26)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.22 (2019-09-26)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.21 (2019-09-24)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.20 (2019-09-20)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.19 (2019-09-10)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.18 (2019-09-09)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.17 (2019-09-05)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.16 (2019-09-04)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.15 (2019-09-04)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.14 (2019-09-01)

Bug Fixes

• update minor updates in packages except react, babel and eslint (#17254) (252d867)

2.1.13 (2019-08-26)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.12 (2019-08-25)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.11 (2019-08-24)

Bug Fixes

• update dependency fs-extra to v8 (#17031) (d891a19)
• update dependency is-relative-url to v3 (#17038) (ff9ae84)

2.1.10 (2019-08-23)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.9 (2019-08-22)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.8 (2019-08-21)

Bug Fixes

• update dependency cheerio to ^1.0.0-rc.3 (#16831) (55bee35)
• update dependency fs-extra to ^4.0.3 (#16876) (2cc762d)

2.1.7 (2019-08-20)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.6 (2019-08-15)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.5 (2019-08-10)

Features

• gatsby-remark-copy-linked-files: change default destinationDir and allow override via config (#16508) (19eab87)

2.1.4 (2019-07-30)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.3 (2019-07-13)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.2 (2019-07-12)

Bug Fixes

• correct links in package changelogs (#15630) (d07b9dd)

2.1.1 (2019-07-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.1.0 (2019-06-20)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.13 (2019-05-29)

Features

• gatsby-remark-copy-linked-files: handle flash object tags (#14381) (ef173e2)

2.0.12 (2019-04-23)

Bug Fixes

• gatsby-remark-copy-linked-files: Support MDX by visiting JSX nodes (#13552) (0b1c9f2)

2.0.11 (2019-03-15)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.10 (2019-03-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.9 (2019-02-01)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.8 (2018-12-17)

Features

• gatsby-remark-copy-linked-files: add support for video elements with src attribute (#10395) (4ceb0f8)

2.0.7 (2018-11-29)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.6 (2018-10-29)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.5 (2018-09-17)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.5 (2018-09-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.4 (2018-09-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.3 (2018-09-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.2 (2018-09-11)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.1 (2018-08-29)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-rc.0 (2018-08-21)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-beta.3 (2018-07-21)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-beta.2 (2018-06-20)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-beta.1 (2018-06-17)

Note: Version bump only for package gatsby-remark-copy-linked-files

2.0.0-beta.0 (2018-06-17)

Note: Version bump only for package gatsby-remark-copy-linked-files