• Docs
  • Tutorial
  • Community
  • Blog

Quick Start

How to contribute

Filing an issue

If you want your issue to be resolved quickly, please include in your issue:

  • Gatsby version, node.js version, OS version
  • The contents of your gatsby-config.js and package.json as well as your gatsby-node.js, gatsby-browser.js gatsby-ssr.js files depending on changes you’ve made there.


You can install the latest master version of Gatsby by following these steps:

  • Clone the repo, navigate to its directory.
  • Install dependencies using yarn install in the root of the repo.

The usual contributing steps are:

  • Fork the official repository.
  • Clone your fork: git clone<your-username>/gatsby.git
  • Install yarn and lerna globaly: npm install -g yarn lerna
  • Checkout to the 1.0 branch: git checkout 1.0
  • Install dependencies: yarn && lerna bootstrap
  • Make sure tests are passing for you: lerna run test
  • Create a topic branch: git checkout -b topics/new-feature-name
  • Run yarn build or npm run build to do an initial build of all packages and ensure there are no errors.
  • Now navigate to the package you want to modify and run yarn run watch to watch that package’s code and compile your changes on the fly as you work.
  • Symlink the built file from the package you’re modifying into your project’s node_modules/package-name directory (this avoids problems we’ve seen with using npm|yarn link)
  • Add tests and code for your changes.
  • Once you‘re done, make sure all tests still pass: yarn test
  • Commit and push to your fork.
  • Create an pull request from your branch.

Test suite can be run via yarn test.

This project uses FlowType for static type checking.