Reference Guides

Nitty-gritty technical descriptions of how Gatsby works. Most useful when you need detailed information about Gatsby's APIs.

Local Development

2 articles

Browse CLI commands like gatsby build and gatsby develop and typical folders and files you'll see inside a Gatsby project.

  • Gatsby Project Structure
  • Gatsby CLI commands

Built-in React Components

2 articles

Gatsby Link and Gatsby Image are drop-in components that improve your site's performance and users' experience.

Routing

2 articles

Generate templated pages like blog posts or products with file system routing.

Config Files

7 articles

Inside its configuration files, Gatsby provides a rich set of lifecycle APIs to hook into its bootstrap, build, and client runtime operations. They allow sourcing data, creating pages, and customizing generated HTML pages.

  • Gatsby Config APIs
  • Gatsby Node APIs
  • See all 7

GraphQL Data Layer

6 articles

APIs for querying your data (PageQuery, StaticQuery, Fragments) and specifying your GraphQL schema (schema customization).

Release Notes

11 articles

Find release notes and guides on how to upgrade Gatsby along with third-party packages.