Skip to content
/ relay Public

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

License

Notifications You must be signed in to change notification settings

facebook/relay

Folders and files

NameName
Last commit message
Last commit date
Jan 22, 2025
May 31, 2023
Mar 22, 2025
Mar 5, 2025
Feb 1, 2022
Mar 21, 2025
Feb 21, 2025
Oct 4, 2024
Mar 21, 2025
May 23, 2023
Apr 23, 2024
Mar 18, 2025
Jun 5, 2024
Jul 13, 2019
Dec 31, 2021
Aug 1, 2024
Nov 9, 2017
Mar 10, 2025
Mar 20, 2025
Mar 20, 2025

Repository files navigation

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!