Relay

Spec sheet

Product

Relay is a GraphQL client for React that coordinates component data needs into efficient, pre-loadable queries.Read 3 Oct 2026 · relay.dev

Integrations

The quick start documents setup with React, Vite, TypeScript, Babel, and the Relay Compiler.Read 3 Oct 2026 · relay.dev

Built-in UI patterns

Relay supports loading states, pagination, refetching, optimistic updates, and rollbacks.Read 2 Oct 2026 · relay.dev

Company and project

The site identifies Meta Platforms, Inc. in its copyright notice and says Relay was built in tandem with GraphQL and is used at Facebook scale.Read 2 Oct 2026 · relay.dev

Data consistency

Relay maintains a normalized data store so components observing the same data stay in sync.Read 3 Oct 2026 · relay.dev

Declarative data

Components declare the data they need, and Relay generates queries to fetch it.Read 3 Oct 2026 · relay.dev

Editor support

Relay editor support provides GraphQL schema autocomplete and go-to-definition.Read 3 Oct 2026 · relay.dev

Generated types

Relay generates TypeScript types for GraphQL snippets, and the homepage also describes generated Flow or TypeScript types.Read 3 Oct 2026 · relay.dev

More features

Relay includes loading states, pagination, refetching, optimistic updates, rollbacks, and streamed or deferred data.Read 3 Oct 2026 · relay.dev

Mutations

Relay supports optimistic updates, error handling, and automatically reverting optimistic changes when mutations fail.Read 3 Oct 2026 · relay.dev

Network customization

The network layer can be customized for behaviors such as network-level caching, telemetry, or form-data uploads for mutations.Read 2 Oct 2026 · relay.dev

Network transports

Developers can configure HTTP, WebSockets, and application-appropriate authentication through Relay's network layer.Read 2 Oct 2026 · relay.dev

Optimizations

Relay aggregates and optimizes component data requirements, including deduplicating identical fields for efficient GraphQL requests.Read 3 Oct 2026 · relay.dev

Production setup

The production guide recommends running the Relay Compiler in CI and keeping generated artifacts in source control.Read 2 Oct 2026 · relay.dev

React Native

The official documentation says Relay also works with React Native.Read 3 Oct 2026 · relay.dev

Requirements

Relay requires GraphQL; its homepage says users need a Babel plugin and must run the Relay Compiler.Read 3 Oct 2026 · relay.dev

Scale

The homepage says Relay is used in Facebook infrastructure across tens of thousands of components and has full-time staff working to improve it.Read 3 Oct 2026 · relay.dev

Security guidance

Relay recommends persisted queries, also called trusted documents, to restrict clients to queries locked in at build time.Read 2 Oct 2026 · relay.dev

Server conventions

Relay provides first-class support for GraphQL Connections when the server supports them and relies on globally unique object IDs for caching and refetching.Read 3 Oct 2026 · relay.dev

Shared state

Relay maintains a normalized data store that keeps components observing the same data in sync.Read 2 Oct 2026 · relay.dev

Streaming

Relay can defer parts of a query and progressively re-render the UI as data streams in.Read 2 Oct 2026 · relay.dev

Supported usage

The homepage says Relay works out of the box with Create React App and Next.js, and identifies Flow or TypeScript users as a likely fit.Read 3 Oct 2026 · relay.dev

Type safety

Relay generates TypeScript types for GraphQL snippets to catch errors statically.Read 2 Oct 2026 · relay.dev

Where Specifiction places it

• GraphQL Tools#20 of 327.1