NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3933 most downloaded on npm
A core runtime for building GraphQL-driven applications.
Last release today
17 Sep 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 54 of 55 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
4280 releases · first in 2017
This release is another massive collection of some exciting new features, fixed bugs and improved error messages and warnings. Thanks to our external
This release is another massive collection of some exciting new features, fixed bugs and improved error messages and warnings. Thanks to our external contributors, summer interns and anyone helping with code or bug reports.
New
@inline directive to inline fragments verbatim for use in utility functions (1b19ee0fb536fd9b28d25fd7b02801256870d68c)--exclude and --include for more control over what files are parsed (94c8b203a95b1366b4034459d1c594e092de92ee)Fixed
Improved
graphql tags (7e1065fd6ea2cbc5e3468029ac2f0ab3b7daf418)loadMore and refetch of the pagination and refetch container is now consistently called after render (e316b6e70c06f03dc4a1160342f1f7c73dc59b20).js.flow files (3e0266c649e993e704f07bb8484cae8938112a71)^0.10.5 (beba4077be30c80327d41dc4871c09c4a9bdabb5)One column per quarter.
Relay v1.1.0 represents a massive number of improvements atop the release of Relay v1.0 last month, including improved error messages, bug fixes, and
Relay v1.1.0 represents a massive number of improvements atop the release of Relay v1.0 last month, including improved error messages, bug fixes, and a handful of new utilities. Special thanks to the Relay team's summer interns, who contributed a number of the improvements below:
Minor breaking:
Set, Map, and Promise are no longer bundled into Relay. (#1870)babel-relay-plugin has been officially removed in favor of babel-plugin-relay (753f1f070e41883788b29ea5e0d87abfce668bdc)babel-plugin-relay. Previously this would insert throw statements into the compiled output, now this produces compiler errors. (c7634da4453f37b804c14230e920839273421767)New:
componentRef to get a ref of the contained component (3571fb9530c5decde1da5ae10fd45179eebc82ba)Fixes:
Viewer type supported correctly (daf38f24b861a76c6acfbd3217e3043a699af991)@relay(plural) (#1810)Today, we're releasing Relay Modern, a new version of Relay designed from the ground up to be easier to use, more extensible, and most of all to impro
Today, we're releasing Relay Modern, a new version of Relay designed from the ground up to be easier to use, more extensible, and most of all to improve performance on mobile devices.
Install the release candidate of react-relay:
yarn add react-relay
Once updating to v1.0, require('react-relay') will return the Relay Modern API. For existing Relay apps, update your code to require the existing Relay Classic API: require('react-relay/classic').
Relay Compiler and Babel plugin:
In development, Relay Modern relies on a Babel plugin (just as Relay Classic does). Relay Modern also uses a compiler to generate runtime code.
yarn add --dev babel-plugin-relay relay-compiler
Once updating to v1.0, the new babel-plugin-relay plugin works with both Relay Modern and Relay Classic, replacing the legacy babel-relay-plugin. It uses much simpler configuration which should feel familiar to your .babelrc files.
More minor issues fixed in this next RC. Thanks to the community for continuing to report after using Relay Modern!
More minor issues fixed in this next RC. Thanks to the community for continuing to report after using Relay Modern!
Changes since rc.3:
getResponse() on Record Source Proxy objects.retry() method in QueryRenderer ready stateContinued thanks to the community for their help in reporting and fixing issues in for Relay Modern! We hope you'll keep trying out the release candid
Continued thanks to the community for their help in reporting and fixing issues in for Relay Modern! We hope you'll keep trying out the release candidates and continue to report how its going.
Changes since rc.2:
relay-compiler including ignoring node_modules and supporting custom file extensions.Thanks to the community for their help in identifying and fixing issues in our first release candidate of Relay Modern! Here's a fresh second Release
Thanks to the community for their help in identifying and fixing issues in our first release candidate of Relay Modern! Here's a fresh second Release Candidate with some fixes for the primary issues encountered by early adopters. We hope you'll try it out and continue to report how it goes for you.
Changes since rc.1:
relay-compiler --watch now actually watches your files. (#1654)import from 'react-relay') no longer includes any compatibility layer (#1631)prop-types instead of using React.PropTypes to allow using React v15.5 without warningsuploaders API to Network in Relay Modern and Classic.Today, we're releasing a first release candidate of Relay Modern, a new version of Relay designed from the ground up to be easier to use, more extensi
Today, we're releasing a first release candidate of Relay Modern, a new version of Relay designed from the ground up to be easier to use, more extensible, and most of all to improve performance on mobile devices.
Install the release candidate of react-relay:
yarn add react-relay@dev
Once updating to v1.0, require('react-relay') will return the Relay Modern API. For existing Relay apps, update your code to require the existing Relay Classic API: require('react-relay/classic').
Relay Compiler and Babel plugin:
In development, Relay Modern relies on a Babel plugin (just as Relay Classic does). Relay Modern also uses a compiler to generate runtime code.
yarn add --dev babel-plugin-relay@dev relay-compiler@dev
Once updating to v1.0, the new babel-plugin-relay plugin works with both Relay Modern and Relay Classic, replacing the legacy babel-relay-plugin. It uses much simpler configuration which should feel familiar to your .babelrc files.
Solved a number of bugs when using the relay-compiler binary
Changes since v1.0.0-alpha.3
The existing babel-relay-plugin will be deprecated in the future. Configuring babel-plugin-relay should be easier as it now relies on modern babel con…
Check it out!
npm install babel-plugin-relay@dev react-relay@dev relay-compiler@dev relay-runtime@dev
Lots of bug fixes, improvements to ease of use and API clarity.
The all new babel plugin: babel-plugin-relay now handles both modern graphql literals and classic Relay.QL literals. The existing babel-relay-plugin will be deprecated in the future. Configuring babel-plugin-relay should be easier as it now relies on modern babel conventions.
An example .babelrc file:
{
"plugins": [
["relay", {"schema": "path/to/schema.graphql"}]
]
}
Flow types are now generated inline in the relay-compiler output, so Relay Modern projects can leverage flow typed GraphQL responses. Recently flow types were added to the results of GraphQL mutations as well.
Generated files are now created inline with your source in __generated__ directories. This makes it easier to require the generated files and simplifies configuring the compiler (no more --out flag).
Support for prototype "live" queries via polling (88d09dcc30f851d8d9abd696d686eb9683b56ba6)
Nothing published for this version
This is the first public alpha release of Modern Relay. While this release is pretty sparse on details and documentation, we wanted to get code to you
This is the first public alpha release of Modern Relay. While this release is pretty sparse on details and documentation, we wanted to get code to you soon so you can help us kick the tires and most importantly make sure that your existing apps are still working.
Install react-relay@dev to get this and future alpha releases.
After installing v1.0.0, existing applications will need to replace require('react-relay') with require('react-relay/classic').
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →