Skip to content
Relay is a JavaScript framework for building data-driven React applications.
JavaScript HTML Other
Branch: master
Clone or download
jstejada and facebook-github-bot Docs v7.0.0
cd oss/__github__/website
yarn run version v7.0.0

Cuts new version v7.0.0 for docs. This ensures that all of the latest updates to the docs are reflected by default in the relay website.

Reviewed By: josephsavona, alunyov

Differential Revision: D18041450

fbshipit-source-id: 0eba68c78726e0c69b7407f3e39ce77a08d3e9ed
Latest commit 16e0caf Oct 21, 2019

Relay Build Status 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 or check out the community-driven tutorial at Learn Relay.


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

git clone
cd relay-examples/todo
yarn build
yarn start

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


We actively welcome pull requests, learn how to contribute.


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


Relay is MIT licensed.

You can’t perform that action at this time.