Gatsby v2

⚛️ 📄 :rocket:

Blazing fast modern site generator for React
Go beyond static sites: build blogs, ecommerce sites, full-blown apps, and more with Gatsby.

Quickstart · Tutorial · Plugins · Starters · Showcase · Contribute · Support: Spectrum & Discord

Gatsby is a modern framework for blazing fast websites.

• undefinedGo 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 ecommerce sites to user dashboards.

• undefinedUse 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 back-end.

• undefinedLoad 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.

• undefinedPerformance Is Baked In. Ace your performance audits by default. Gatsby automates code
  splitting, image optimization, inlining critical styles, lazy-loading and prefetching resources,
  and more to ensure your site is fast — no manual tuning required.

• undefinedHost 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 services like GitHub Pages and Netlify.

undefinedLearn how to use Gatsby for your next project.undefined

What’s In This Document

• Get Up and Running in 5 Minutes
• Learning Gatsby
• Migration Guides
• How to Contribute
• Thanks to Our Contributors and Sponsors

🚀 Get Up and Running in 5 Minutes

You can get a new Gatsby site up and running on your local dev environment in 5 minutes with these three steps:

1. undefinedCreate a Gatsby site from a Gatsby starter.undefined

   Get your Gatsby blog set up in a single command:

   # install the Gatsby CLI globally
   npm install -g gatsby-cli
   
   # create a new Gatsby site using the default starter
   gatsby new my-blazing-fast-site
   

2. undefinedStart the site in develop mode.undefined

   Next, move into your new site’s directory and start it up:

   cd my-blazing-fast-site/
   gatsby develop
   

3. undefinedOpen the source code and start editing!undefined

   Your site is now running at http://localhost:8000. Open the my-blazing-fast-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.

• undefinedFor 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.

• undefinedTo dive straight into code samples head to our documentation. In particular, check out the “Guides”, API reference, and “Advanced Tutorials” sections in the sidebar.

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

undefinedStart Learning Gatsby: Follow the Tutorial · Read the Docsundefined

💼 Migration Guides

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

• Migrate a Gatsby site from v1 to v2
• Still on v0? Start here: Migrate a Gatsby site from v0 to v1

🤝 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! :muscle::purple_heart:

Check out our contributor onboarding docs for ideas on contributing and setup steps for getting our repos up and running on your local machine.

undefinedRead the Contributing Guideundefined

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. 💪💜

undefinedRead the Code of Conductundefined

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.

Contributing to Gatsby v1

We are currently only accepting bug fixes for Gatsby v1. No new features will be accepted.

💜 Thanks to Our Contributors and Sponsors

Thanks to our many contributors and sponsors as well as the companies sponsoring
our testing and hosting infrastructure: Travis CI, Appveyor, and Netlify.