facebook/relay

Health v2 · maintenance only

Adoption not part of the score

18957 stars · 1895 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Relay is a JavaScript framework and GraphQL client for building data-driven React applications, where components declaratively declare their data requirements and Relay's compiler aggregates and optimizes queries. It provides a normalized client-side store, mutations with optimistic updates, type-safe generated TypeScript types, and built-in UI patterns like pagination, refetching, and streaming/deferred data.

Use cases

• fetch data in react components with graphql
• declarative data fetching for react app
• generate typescript types from graphql queries
• manage normalized client-side cache for graphql
• prefetch graphql queries before code loads
• handle pagination and optimistic updates in react
• colocate graphql queries with react components

When to choose

• building a large-scale React application backed by a GraphQL API
• you want type-safe, colocated, composable data requirements per component
• you need automatic query aggregation, deduplication, and a normalized store
• you want built-in pagination, refetching, and optimistic update patterns

When to avoid

• your backend is REST rather than GraphQL
• you want a lightweight client for a small app with simple data needs
• your team is unwilling to adopt Relay's compiler and conventions
• you use a framework other than React

Facets

framework · maturity stable

graphql graphql-client state-management http-client frontend-framework compiler type-system frontend web-development apis cross-platform react data-fetching declarative-ui normalized-store optimistic-updates typescript-codegen meta-open-source javascript nodejs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="facebook/relay")