Relay is a JavaScript framework for building data-driven React applications. https://relay.dev
Find a file
Tianyu Yao 160bcf5c78 Fix incremental build missing mutation field return type changes
Reviewed By: evanyeung

Differential Revision: D97396237

fbshipit-source-id: a810c53cc55e695df0677b3fdb108d9bb328f90e
2026-03-19 17:54:25 -07:00
.claude Add Fix CI Skill label to PRs and update Cargo.lock (#5180) 2026-02-20 13:43:15 -08:00
.github Fix Cargo.lock update PRs being immediately auto-closed (#5185) 2026-02-25 12:59:14 -08:00
.vscode Add VSCode tasks for common commands (#5003) 2025-05-29 16:56:10 -07:00
compiler Fix incremental build missing mutation field return type changes 2026-03-19 17:54:25 -07:00
flow-typed transformTypeParamBound codemod 4/9 2026-03-05 16:52:37 -08:00
meta Update non-mutation documentation 2022-02-01 13:10:14 -08:00
packages Remove $FlowFixMe[missing-local-annot] in RelayModernEnvironment-ExecuteWithDefer-test 2026-03-19 14:31:57 -07:00
scripts Add @relayType and @relayField docblock tags for Relay Resolvers (#5179) 2026-02-24 09:59:56 -08:00
vscode-extension Bump lodash from 4.17.21 to 4.17.23 in /vscode-extension (#5147) 2026-01-29 17:00:34 -08:00
website Remove Support Ukraine banner from Relay website 2026-03-16 06:36:16 -07:00
.eslintignore Ignore vscode-extension in root eslintignore (#4322) 2023-05-23 10:17:05 -07:00
.eslintrc.js Revert D74735939 2025-05-29 21:29:50 -07:00
.flowconfig Deploy 0.305.1 to xplat 2026-03-16 15:36:17 -07:00
.gitignore Improve compiler explorer (#4698) 2024-06-05 14:36:52 -07:00
.prettier-plugins.fb.js Update prettier-plugin-hermes-parser in fbsource to 0.31.1 2025-08-01 20:18:36 -07:00
.prettierrc.js Fork internal vs external prettier plugin resolution 2025-07-23 09:59:21 -07:00
.watchmanconfig Make .watchmanconfig valid JSON (#2797) 2019-07-13 16:00:15 -07:00
crowdin.yaml Use Docusaurus for the website 2017-11-09 12:58:26 -08:00
gulpfile.js Remove bundler setup (#4935) 2025-03-10 11:11:59 -07:00
LICENSE Update copyright headers from Facebook to Meta 2021-12-31 14:28:28 -08:00
package.json Deploy 0.305.1 to xplat 2026-03-16 15:36:17 -07:00
README.md Update README.md (#4738) 2024-08-01 13:51:05 -07:00
yarn.lock Upgrade minimatch 3.1.2 → 3.1.4 (CVE-2026-27903, CVE-2026-27904) 2026-03-19 11:03:15 -07:00

Relay · GitHub license npm version

Relay is a JavaScript framework for building data-driven React applications.

  • Declarative: Never again communicate with your data store using an imperative API. Simply declare your data requirements using GraphQL and let Relay figure out how and when to fetch your data.
  • Colocation: Queries live next to the views that rely on them, so you can easily reason about your app. Relay aggregates queries into efficient network requests to fetch only what you need.
  • Mutations: Relay lets you mutate data on the client and server using GraphQL mutations, and offers automatic data consistency, optimistic updates, and error handling.

See how to use Relay in your own project.

Example

The relay-examples repository contains an implementation of TodoMVC. To try it out:

git clone https://github.com/relayjs/relay-examples.git
cd relay-examples/todo
yarn
yarn build
yarn start

Then, just point your browser at http://localhost:3000.

Contribute

We actively welcome pull requests, learn how to contribute.

Users

We have a community-maintained list of people and projects using Relay in production.

License

Relay is MIT licensed.

Thanks

We'd like to thank the contributors that helped make Relay in open source possible.

The open source project relay-hooks allowed the community to experiment with Relay and React Hooks, and was a source of valuable feedback for us. The idea for the useSubscription hook originated in an issue on that repo. Thank you @morrys for driving this project and for playing such an important role in our open source community.

Thank you for helping make this possible!