Gatsby v2 Beta

⚛️📄🚀 Blazing-fast site generator for React

NOTE: This branch is the beta version of Gatsby v2. You can find documentation at next.gatsbyjs.org.

For gatsby@1, please see the v1 branch.

Are you using v1 and want to upgrade to the Gatsby v2 Beta? Check out our v1 => v2 migration guide.

Starting a new project with Gatsby v2 If you'd like to start a new project with Gatsby v2 you can use the v2 edition of any offical starter. Install your favourite one with the Gatsby CLI.

gatsby-starter-default with v2:

gatsby new my-default-project https://github.com/gatsbyjs/gatsby-starter-default#v2

gatsby-starter-hello-world with v2:

gatsby new my-hello-world https://github.com/gatsbyjs/gatsby-starter-hello-world#v2

gatsby-starter-blog with v2:

gatsby new my-blog https://github.com/gatsbyjs/gatsby-starter-blog#v2

If you're a start from scratch kind of person, you can install the Gatsby beta and React like this: npm install gatsby@next react react-dom

How are pull requests being handled during the v2 beta?

The following policy will be in place during the v2 beta:

• We will only accept bug fixes for Gatsby v1. Any PRs opened against v1 that are not bug fixes will be closed

• If the bug fix is applicable to v2, we will open an additional issue to track porting the change to v2

• All new features should be opened as pull requests against v2 (the master branch)

We're using this policy as the Gatsby team currently spends a significant amount of time maintaining two active branches - the v1 branch and the v2 branch - we'd like to limit this work to focus on getting v2 released and start working on oft-requested new features like schema snapshots and schema stitching.

Showcase

Websites built with Gatsby:

• React (source)
• Sourcegraph
• Simply
• The freeCodeCamp Guide (source)
• Storybook (source)
• Learn Storybook (source)
• FloydHub's Blog
• mParticle's Documentation
• Segment's Blog
• Fabric
• Formidable
• Ledgy (source)
• openFDA (source)
• Bricolage.io (source)
• Hack Club (source)
• High School Hackathons (source)
• Jamie Henson's Blog (source)
• Sean Coker's Blog
• Dustin Schau's Blog (source)
• The Chiedo Companies Website
• Damir.io (source)
• Ruben's Blog (source)
• Kostas Bariotis' Blog (source)
• Thao Am Private Enterprise
• Bakadono
• Travellers.cafe
• Oliver Benns' Portfolio (source)
• angeloocana.com (source)
• knpw.rs (source)
• Overlap.show (source)
• smartive Company Website
• Haboba Find Jobs at Phu Quoc Island
• Charlie Harrington's Blog (source)
• Song Wang’s website (source)
• Digital Psychology (source)
• Magicly's blog (source)
• Dalbinaco's website (source)
• Phu Quoc Works
• Kabir Goel's website (source)
• Gabriel Adorf's Portfolio (source)
• CSS Grid Playground by MozillaDev (source)
• David James' Portfolio (source)
• Tic Tac Toe AI (source)
• Etcetera Design (source)
• Azer Koçulu
• Random Screencast
• Phu Quoc Tea & Coffee Store
• Steven Natera's blog
• LekoArts - Graphic Designer Portfolio (source)
• Georgi Yanev (source)
• OnCallogy.com
• doopoll's marketing site
• Design Systems Weekly
• Slite landing pages
• Hallingdata
• @swyx (source)
• Portfolio of Piotr Fedorczyk
• JavaScript Stuff
• GRANDstack - GraphQL, React, Apollo, Neo4j Database
• GraphCMS's website
• Mannequin.io (source)
• Calpa's Blog (source)
• API Platform (source)
• Bottender Docs (source)
• How to GraphQL (source)
• greglobinski.com (source)
• Vibert Thio's Portfolio(source)
• YouFoundRon.com (source)
• heml.io (source)
• 伊撒尔の窝
• Artivest's Public Website
• William Owen UK
• NYC Planning Labs (New York City Department of City Planning)(source)
• The State of European Tech 2017
• Santa Compañía Creativa (source)
• Pravdomil (source)
• Fabian Schultz' Portfolio (source)
• Caddy smells like trees - Free-folk band official page (source)
• BRIIM
• KNW Photography (source)
• NEON
• A4 纸网(source)
• manu.ninja (source)
• Kris Hedstrom's Portfolio (source)
• Chocolate free website (source)
• Charles Pinnix Website
• Verious (source)
• Developer Ecosystem
• Steve Meredith's Portfolio
• Landing page of Put.io
• Ryan Wiemer's Portfolio (source)
• yerevancoder (source)
• unrealcpp (source)
• several levels (source)
• Flooring Factories Outlets
• Nortcast
• VisitGemer
• Nexit
• ERC dEX
• iContract Blog
• Dona Rita (source)
• Andy Slezak (source)
• Odayaka (source)
• Ventura Digitalagentur Köln
• Cardiogram
• LaserTime Clinic (source)
• Gatsby Manor - themes for GatsbyJS
• Darren Britton's Portfolio (source)
• Portfolio / Blog of Preston Richey (source)
• Beach Hut Poole
• In Sowerby Bridge
• 枫上雾棋的日志
• Juliette Pretot's Portfolio
• Théâtres Parisiens (source)
• Jia Hao's Website / Blog (source)
• Orbit FM Podcasts (source)
• Michele Mazzucco's Portfolio (source)
• Rung
• Óbuda University - EE Faculty Student Union Website
• Neostack
• Prosecco Springs
• Fröhlich ∧ Frei
• Alec Lomas's Portfolio & Blog (source)
• Alex Pate - Blog/Portfolio (source)
• Matthias Jordan - Portfolio (source)
• Daniel Hollcraft (source)
• Investment Calculator
• Nikbelikov.ru
• Watchcards.ru
• John Meguerian's Portfolio (source)
• Krashna Musika Association Website (source)
• Deliveroo.Design
• The Rick and Morty API
• Adnan Fajlur - Portfolio
• Hapticmedia
• Smakosh (source)
• Philipp Czernitzki - Blog/Website
• CodeBushi
• WebGazer
• Joe Seifi's Blog
• Bartosz Dominiak Blog/Portfolio (source)
• The Audacious Project
• upGizmo
• The Bastion Bot
• Yuuniworks (source)
• Chin Loong Tan - Blog/Portfolio
• F1 Vision
• GraphQL College (source)
• Hyunwoo Kim - Blog/Portfolio (source)
• Abinav Seelan - Personal Website (source)
• Dovetail
• Bart van der Waerden Blog (source)
• Canella Riccardo - Portfolio (source)
• Eviction Free NYC! (source)
• Rafael Belliard's Portfolio (source)
• Tinder Interracial Couple Emoji Project
• aQuICK (source)
• Workshop In The Woods (source)
• Steven Koerts - Portfolio(source)
• Ray Gesualdo - Personal Website (source)
• 10M GmbH
• Edge Database
• Rolling Stone: The New Classics
• Jacob Bolda - Personal Website
• Apideck
• GDPR Checklist (source)
• GDPR Tracker
• GDPR Form
• Josh Palacios - Personal Website (source)
• Cup of Data (source)
• Natalia Acevedo - Personal Website (source)
• Airbnb Cereal
• mottox2 blog
• Tiger Facility Services
• Jersey Watch
• Bench Accounting
• 杨二的博客
• GaiAma - We are wildlife (source)
• Rescue Amazonian Rainforest (source)
• Michael McQuade - Personal Blog (source)

Docs

View the docs on gatsbyjs.org

Migrating from v1 to v2?

Migrating from v0 to v1?

v0 docs

Packages

This repository is a monorepo managed using Lerna. This means that we publish many packages to NPM from the same codebase.

Thanks

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

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on GitHub with a link to your site. [Become a sponsor]