# Relay

JavaScript framework for building data-driven React applications on GraphQL, with a compiler that precomputes each component's queries.


Source: https://findsoftware.frbit.cloud/relay/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://relay.dev/
- repository: https://github.com/meta/relay
- docs: https://relay.dev/docs/
- x: https://twitter.com/RelayFramework/

### Identity

- status: active
- maintainer: Meta Platforms, Inc.
- maintainerType: company
- parent: unknown
- firstRelease: 2015
- hqCountry: unknown

### Kind

- category: framework
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- basedOn: react

### Content

- contentStore: unknown
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: unknown
- renderingModes: unknown
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 21
- latestReleaseDate: 2026-05-27

### Adoption

- githubStargazers: 18981
- packagistDownloads: not applicable
- npmWeeklyDownloads: 6115613
- contributors: 291
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 76213
- dependentPackages: 210

### Sources

- urls: https://relay.dev/ (read 2026-11-16)
- urls: https://api.github.com/repos/meta/relay (read 2026-11-16)
- urls: https://relay.dev/docs/ (read 2026-11-16)
- category: https://github.com/meta/relay/blob/main/README.md (read 2026-11-16)
- language: https://github.com/meta/relay/blob/main/README.md (read 2026-11-16)
- basedOn: https://github.com/meta/relay/blob/main/README.md (read 2026-11-16)
- installMethod: https://relay.dev/docs/getting-started/quick-start/ (read 2026-11-16)
- license: https://api.github.com/repos/meta/relay (read 2026-11-16)
- maintainer: https://github.com/meta/relay/blob/main/LICENSE (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/react-relay (read 2026-11-16)
- currentMajor: https://github.com/meta/relay/releases/tag/v21.0.1 (read 2026-11-16)
- latestReleaseDate: https://github.com/meta/relay/releases/tag/v21.0.1 (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/meta/relay (read 2026-11-16)
- contributors: https://api.github.com/repos/meta/relay/contributors?per_page=1 (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/relay-runtime (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/relay-runtime (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/relay-runtime (read 2026-11-16)

## Notes

Relay is a JavaScript framework for building data-driven React applications on GraphQL. Each component declares the data it needs, and the Relay compiler aggregates those declarations into GraphQL requests at build time. At runtime, the Relay store keeps every component that reads the same data up to date.

The [Relay documentation](https://relay.dev/docs/) describes the framework, and its [quick start](https://relay.dev/docs/getting-started/quick-start/) walks through adding Relay to a React project.

## Worth knowing

Relay requires a Babel plugin and the Relay Compiler, so a build step is part of the setup. It also makes assumptions about the GraphQL server: that it provides a way to refetch an object and a description of how to page through connections. The [GraphQL server specification](https://relay.dev/docs/guides/graphql-server-specification/) spells them out.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
