How gatsbyjs/gatsby works
Gatsby is a React framework for building content-rich sites and apps. The documented workflow is to load content from sources, query it through a uniform GraphQL interface, create pages, render them with a mix of static, deferred, or server-side strategies, and deploy the resulting site. The graph also shows job execution, remote-image handling, and adapter output as internal layers. README capabilities guide the high-level flow; sampled source is limited, so links to unsampled subsystems are omitted or kept at documented boundaries.
Main entry points: src Gatsby framework · adapter/manager.ts Site assets and routes · http-routes.ts Remote image routes · jobs/manager.ts Plugin jobs
Components 13
Site authoring
- Gatsby framework
packages/gatsby/src
Content and data
- Content sources
- Data sourcing
packages/gatsby/src - GraphQL interface
packages/gatsby/src - Plugin jobs
packages/gatsby/src/utils/jobs/manager.ts - Remote image routes
packages/gatsby-plugin-utils/src/polyfill-remote-file/http-routes.ts
Rendering runtime
- Page creation
packages/gatsby/src - Page rendering
packages/gatsby/src
Site delivery
- Adapter manager
packages/gatsby/src/utils/adapter/manager.ts - Site assets and routes
packages/gatsby/src/utils/adapter/manager.ts
Other components
- Site developer
- Site visitor
- CDN or host
Connections 14
- Site developer → Gatsby framework: configures site
- Content sources → Data sourcing: provides content
- Gatsby framework → Data sourcing: loads data
- Data sourcing → GraphQL interface: exposes data
- Gatsby framework → GraphQL interface: provides queries
- Gatsby framework → Plugin jobs: runs plugin jobs
- Gatsby framework → Page creation: creates pages
- GraphQL interface → Page creation: supplies query data
- Page creation → Page rendering: selects rendering
- Site visitor → Page rendering: requests page
- Page rendering → Site visitor: serves app
- Adapter manager → Site assets and routes: assembles routes
- Site assets and routes → CDN or host: deploys assets
- Remote image routes → Site visitor: serves image files