Skip to main content
Version: v3.x (DDN)

Supergraph

Introduction​

A supergraph is essentially the API for your project. It provides a unified interface for interacting with your data and serves as the backbone for building applications that rely on multiple data sources.

Components​

The supergraph is made up of several key components that work together to deliver a seamless API experience:

  • Subgraphs: These represent different data domains and can include multiple data connectors to bring in data from various sources.
  • Builds: A supergraph consists of immutable builds. At any given time, one build is applied, and it can be easily rolled back to a previous state if necessary.

How it all works​

The supergraph is defined using Hasura Metadata Language, which the engine uses to generate and serve the API. This metadata acts as the blueprint for everything, including:

  • Defining roles and permissions to control access.
  • Configuring authentication mechanisms.
  • Defining relationships across and between data sources.
  • Specifying the GraphQL fields and types exposed by the API.

By centralizing these configurations, the supergraph ensures consistency and simplifies collaboration across teams.

Next steps​