gatsby

Create new site

$ gatsby new [site-name]

$ gatsby new [site-name] [https://github.com/user/starter]

$ gatsby develop

$ gatsby build

$ gatsby serve

$ gatsby clean

$ gatsby info

gatsby command [options]

gatsby is a React-based static site generator that creates fast, optimized websites using React components and GraphQL for data fetching. It combines modern web technologies with automatic code splitting, image optimization, and progressive enhancement.
Gatsby builds static HTML at build time while maintaining React's interactive capabilities through hydration. The framework uses a rich plugin ecosystem for integrating CMSs, APIs, and services. GraphQL provides a unified data layer for querying content from multiple sources.
The development server includes hot module replacement for rapid iteration, while production builds are optimized for performance with techniques like prefetching, lazy loading, and asset optimization.

-H, --host host

Development server host.

Development server port.

Build with path prefix.

gatsby-config.js

Main configuration file for plugins, site metadata, and build settings.

Node API configuration for dynamic page creation and build-time customization.

new

Create new site.

Start development server.

Build production site.

Serve production build.

Clean cache and artifacts.

Show environment info.

Interactive REPL.

Build times can be slow for large sites. GraphQL layer has learning curve. Some plugins may be outdated. Real-time data requires client-side fetching. Requires Node.js and npm.

Gatsby was created by Kyle Mathews in 2015 as a modern static site generator. It gained popularity for combining React with GraphQL and was acquired by Netlify in 2023. The framework helped popularize the Jamstack architecture.

npm(1), webpack(1)