2.0.0-rc.2

Commits: https://github.com/facebook/relay/compare/v2.0.0-rc.1...v2.0.0-rc.2

Breaking

• Merge graphql-compiler into relay-compiler (#2593)
• Selector type returned by environment.unstable_internal.getSelector(...) has changed.

Added

• ReactRelayContext is now exported from react-relay.
• Added fragment ownership model to relay-runtime: fragments can now point to the query that owns them, which removes reliance on React Context and gives us flexibility to experiment with new apis.
• Persisted queries: Enables a simple but straightforward mechanism to use persisted queries in open-source. (#2354)
• @arguments directive now supports literal values.

Experimental

• Added support for new @match directive for dynamically loading code and data dependencies determined by server. No user api is provided yet.
• Added support for @refetchable directive which automatically generates a query for a fragment that is “refetchable” (i.e. a fragment on Viewer, Query, or a type that implements Node). No user api is provided yet.

Fixed

• Fixed receiving payloads out of order in QueryRenderer.
• Fixed issue in Pagination Container when receiving new props.

Improved

• Improved compiler error messages, which now show locations in source.
• Updated the structure of generated ConcreteRequest to provide more flexibility for our fetching apis.
• Cleaned up Reader and Normalization AST representation.

Commits: https://github.com/facebook/relay/compare/v1.7.0-rc.1...v2.0.0-rc.1

Breaking

• Relay now uses new Context API instead of Legacy Context API. Any consumers of Relay context using the Legacy context API will break.
  • Although not officially supported, this change also breaks SSR with Relay: https://github.com/facebook/relay/issues/2544. We will fix this issue in 2.0.0-rc.2.
• Removed experimental support for @deferrable directive
• Upgrade graphql to 14.0.0
• Upgrade react to 16.5.0
• relay-compiler: Rename inputFieldWhitelist to optionalInputFields.

Added

• Add 'severity' field to PayloadError in RelayNetwork interface.
• Add support for specifying missingFieldHandlers in the Relay environment. These handlers allow developers to provide a fallback for missing data for a query when environment.check() is called.
• Add support making GC scheduling configurable in the Relay environment.
• Allow passing a custom handler to @connection. This is useful for products that want to customize the way newly fetched items are merged into an existing connection.

Experimental

Added a new relay-experimental package which exposes a few experimental APIs.

• Add fetchQuery_UNSTABLE api to fetch and retain data outside of React.
• Add SuspenseQueryRenderer and SuspenseFragmentContainer. These are new versions of our containers that use Suspense to communicate loading states.

Fixed

• Fix incorrectly garbage collecting data during an optimistic update.
• Correctly fix double fetching with QueryRenderer in React Concurrent mode.
• Fix rendering sibling QueryRenderers that have the same query and variables.

Improved

• Upgrade build dependencies to Babel 7 and Webpack 4.
• Make generated Flow types for Input types exact objects.
• Simplify structure of network payloads.
• Rename RelayMarkSweepStore to RelayModernStore.

Commits: https://github.com/facebook/relay/compare/v1.6.2...v1.7.0

This release comes with two exciting contributions from external contributors:

Language Plugins

While we at Facebook only support JS and Flow flavored JS and generate optional Flow types, supporting TypeScript had been difficult. #2293 by @alloy does the required refactoring to allow other developers to write plugins to add this missing support.

Create React App support

Create React App tries to minimize dependencies, so including Relay's Babel plugin for everyone didn't make much sense. This meant that using Relay with Create React App wasn't possible without ejecting.
This release adds babel-plugin-relay/macro (@apalm, #2171) which in the upcoming [email protected] will make it possible to use Relay without ejecting powered by babel-plugin-macros (http://yarn.pm/babel-plugin-macros).

Added

• Support for language plugins (@alloy, #2293)
• Support for babel-plugin-macros (@apalm, #2171)
• Updated to [email protected] to extract GraphQL strings for the compiler
• Pagination and Refetch containers now warn when a request is triggered when they're unmounted. (@alunyov)

Fixed

• Fix double fetching in QueryRenderer in React Concurrent mode (@flarnie)
• Fix rendering sibling QueryRenderers that have the same query and variables
• relay-compiler is no longer a peerDependency of relay-runtime as it's not needed during deployment. Make sure to keep all Relay packages at the same version! (@kassens)

Removed

• Removed long deprecated RelayNetwork.streamQuery and RelayNetwork.sendSubscription

1.7.0-rc.1

This release doesn't contain many commits, but comes with two exciting additions from external contributors:

Language Plugins

While we at Facebook only support JS and Flow flavored JS and generate optional Flow types, supporting TypeScript had been difficult. #2293 by @alloy does the required refactoring to allow other developers to write plugins to add this missing support.

Create React App support

Create React App tries to minimize dependencies, so including Relay's Babel plugin for everyone didn't make much sense. This meant that using Relay with Create React App wasn't possible without ejecting.
This release adds babel-plugin-relay/macro (@apalm, #2171) which in the upcoming [email protected] will make it possible to use Relay without ejecting powered by babel-plugin-macros.

Added

• Support for language plugins (@alloy, #2293)
• Support for babel-plugin-macros (@apalm, #2171)
• Updated to [email protected] to extract GraphQL strings for the compiler
• Pagination and Refetch containers now warn when a request is triggered when they're unmounted. (@alunyov)

Fixed

• Fix double fetch in React Async development mode (@flarnie)
• relay-compiler is no longer a peerDependency of relay-runtime as it's not needed during deployment. Make sure to keep all Relay packages at the same version! (@kassens)

Removed

• Removed long deprecated RelayNetwork.streamQuery and RelayNetwork.sendSubscription

1.6.2

Fixed:

• Fix relay-runtime main entry for OSS
• Fix documentation page for Mutations

Commits: https://github.com/facebook/relay/compare/v1.6.0...master

Potentially Breaking:

• Bump graphql peer dependency to ^0.13.0
• Use React.forwardRef. This is a breaking change for people relying on the relayContainer.refs.component implementation detail.

New:

• Introduce @relay(mask: false) directive for fragment *definitions: *Applied to a fragment definition, @relay(mask: false) changes the generated Flow types to be more usable when the fragment is spread with the same directive; The Flow types will no longer be exact objects and no longer contain internal marker fields.

Fixed:

• Fix pagination after using refetchConnection in Pagination Container
• Use aliases for __typename generated fields in the union (#2465)
• Fix issue in React Async mode where container would render inconsistent data if rendering was interrupted.
• RelayConnectionHandler now properly writes page_info after refetching a connection
• Fix issue where RelayContainerUtils didn't recognize React.forwardRef as React.Component
• Properly guard agains errors thrown inside mutation or subscription updater functions

Improved:

• De-hastify relay-runtime, set main entry in relay-runtime package.json.
• dedupeJSONStringify is now more effective
• Speed up relay-compiler by caching client schema extensions.
• Expose applyOptimisticUpdate on RelayModern.
• relay-compiler can now compile JS files with optionalChaining syntax.
• relay-compiler can now compile JS files with nullishCoalescingOperator syntax.
• relay-compiler can now compile JS files with optionalCatchBinding syntax.
• relay-compiler has better warnings when required variables are not passed in.
• relay-compiler now generates operation Flow types: 5d83328.
• Bump fbjs dependency to 0.8.17.
• Bump fast-glob dependency to 2.2.2.
• Several documentation improvements.

1.6.0

Commits: https://github.com/facebook/relay/compare/v1.5.0...v1.6.0

Breaking:

• The minimum React dependency was raised to ^16.3.0

Potentially Breaking:

• Remove some usages of deprecated React lifecycle methods and changes to make containers React Async safe.
• Remove support for legacy __type__ fields
• Remove support for parsinglegacy interfaces(51c5761)

Fixed:

• Make jest --watch work with React 16
• Fix flow type generation for recursive Input types

Improved:

• Move graphql-compiler out of relay-compiler as its own independent package
• Make graphql a peer dependency
• Upgrade graphql-js to v0.13.2
• Support batch queries in Refetch and Pagination containers
• relay-compiler: Makes flow generated '%future added value' for enums optional

This release introduces several changes, some of the most relevant ones are highlighted here.

New:

• Relay Containers are now Flow typed, however Flow types are not yet exported (#2284).
• Relay Compiler now generates Flow types for GraphQL enum values.
• Add undocumented support for client-only schema extensions using .graphql files. Extensions only work on existing types, and does not currently support adding client-only types to the schema.
• Add experimental and undocumented support for QueryRenderer to render directly from store if data is available using new dataFrom prop.
• Add hooks to enable and disable Relay GC in the store.
• New ConcreteNode format supporting Batch requests.

Potentially Breaking:

• Support for client-only schema extensions requires that your GraphQL schema not be inside your the directory you specify as src to the relay-compiler (#2346).
• Changes the type of RelayNetwork.execute to return a RelayObservable with variables and node, in addition to the QueryPayload. However, RelayNetwork.create maintains the same API (c058ffc4).

Fixed:

• Fix passing a single item to a "list" input argument (42c11193).
• Fix end cursor when fetch returned zero edges in Pagination Container (a17b462b).
• No longer throw false alarm error in RelayConcreteVariables (03985855).
• Properly handle complex GraphQL argument literals in the compiler (bb02769f).
• Calling viewer handler multiple times should not accidentally cause viewer to be null (f442fcd4).
• Fix issue when using multiple connectionInfo for RANGE_ADD mutation (7f2013d6).
• Fix issue in Relay Compiler when parsing non-null input (4baa970d).
• Fix pagination on empty connections (62c8b43f).

Improved:

• Ensure the Relay build has run and is not using outdated GraphQL fragments. Optionally this can be turned off in the babel plugin settings (a628637d).
• Update all callers of react-relay to use CommonJS requires.
• Speed up getIdentifierForSelection.
• Compiler doesn't warn on missing fields with abstract types anymore.
• Relay Compiler now de-duplicates identical objects when generating JSON artifacts which decreases size of artifacts and improves compressability.
• Disable NoFragmentCyclesRule; can now use Fragments recursively.
• Remove RecordSourceInspector which is of marginal value, especially now that we have a useful devtools app.
• Print timing information in compiler —verbose mode.
• Add option to Compiler to be —quiet.
• Upgrade to graphql-js v0.13.0.
• Upgrade to latest version of fast-glob.
• Upgrade to babylon7 in Relay Compiler to support new JSX Fragment syntax.
• Remove graphql.experimental.
• Several Flow typing improvements.
• Several documentation fixes.
• Move test utils to their own package: relay-test-utils.
• Add support for accessing Components wrapped in a Container in tests.
• Use jest snapshots for relay-compiler tests.

New:

• This is the first NPM release to include the MIT license. Read more about this change: https://medium.com/@leeb/relicensing-the-graphql-specification-e7d07a52301b (6d87a701de69ce1e271895ff689ddbda2b39b4c2 cherry-picked as 87b4eb6423adbcb4e0d89cfd0eb81a82a7ec33a9)

New:

• Full support for returning Observable from Relay Network implementations. Use const {Observable} = require('relay-runtime') to use Relay's lightweight Observable implementation which seeks to follow the Observable specification.
• Support for the new Relay DevTools beta (install with yarn add relay-devtools) (86b63d44a2228705975294d4bfcd34ea2de88f92)
• Support for latest version of Flow
• Deprecated graphql.experimental All features now supported directly in graphql literal tags. (9afd76498942ef8c7c8de64c6bfc5b1da2a1dd65)
• Pagination container now accepts an Observer when loading more data (ef7aa5bf2963d4de592a86109b2bec0a9931b813)

Potentially Breaking:

• Relay Network and Environment internal APIs renamed to execute() and executeMutation() (0202673f046cd9a52181388c9910ab1e6082e803)
• Removed legacy flow type generation (8cf10b9f9d670f2723e12a1d2176cba64a2416d4)

Fixed:

• Case where callback might not be called after mutation (980de6de8a5bb282905e11e4c93feca87eb2e148)
• Improved printing of queries with @include in classic/compat mode (d65291156865c52e67e6afb0473a07879979b54d)
• Improved error messages (d8eb6d455a48802080a7acdb7f82dbd4cc4ce47e)
• Fix case where compiler might not place __typename and id in the correct order (95319d19c2027661efd400eea3137ba7b6885431)
• Fix deferred queries when root arguments are not of type ‘ID’ (5ac92718002af0150ecb6a04636a2f70edeb7e74)
• Fixed remaining issues for compatibility with React v16.
• Fix passing default arguments to @arguments in compat mode (1ce348a5bc472a58607279c08e2236b8459b5877)
• Fix issues in QueryRenderer when queries resolve synchronously and immediately (87bfc91055a59654bf4f5f74d5a2fab8de8e947d)
• Fix case where @argumentDefinitions would not be validated first (50803a5c3951ff7f34fa46bc5ad774fba12dc111)
• Change readyState to getDefaultState value after retry (beaf5c27117f30ec591ca587bdab0a786903490e)

A small update since 1.2.0 that mainly exposes a few new internals.

New:

• graphql tags now support null literal values (@nkohari e7962fb9338b41ed3c9a302384d26a86b7514c0a)
• Refactored RelayEnvironment to use Observables instead of Promises to prepare for streaming and other advanced usages (@leebyron)
• Expose formatGeneratedModule on relay-compiler to allow more customization of the compiler (@robrichard 7b440133446681d660d785c11c137d029fcf804f)
• New CLI flag --validate to relay-compiler to validate without writing files (@ajhyndman af35c307e16e613e4dee46dba040c0c990919b3c)
• RelayConnectionInterface is now injectable for legacy clients (@kassens d9c1eb08f043e369dc5d584968b96d5c3bd11ad9)

Fixed:

• Various documentation fixes (@mattleff)
• Some exceptions in the compiler were only printing to console, but not causing an error code (@kassens 14e28dd4fb1c5be367f0512efdba0dc0408f69fe)
• RelayRecordProxy#setValue now accepts arrays of scalar values (@kassens 7a2b27ea0e93d37857358707f40a2ededef0cfdc)
• Removed eslint-config-fbjs dependency from relay-compiler (@mwalkerwells 7b914f0ec7b49004a9d63107884e501a92020b95)

In addition to all of the changes in v1.2.0-rc1, v1.2.0 includes:

New:

• Unmasked fragment spreads introduced in the RC have been renamed from @inline to @relay(mask: false) (c7235ab93d832f3f41f6c728a0dc9e5549d31c5d) and can be used in both Relay modern and Relay compat (20327fd8b4af2ae3c8a254d8878f74c9d3d63e4a)
• Full queries are generated in development builds for easier debugging (9a81b3f83ae36fcd6bf768870e2dca09f39f9d48)
• Relay compiler now allows disabling watchman for typical builds (@robrichard 4f80e02205a05f05439a724c2620a80f2fd95737)
• No longer explicitly need to include pageInfo when using pagination controllers (9686119769ea8fb7da684215a572fdeee2a1f92e)
• Experimental support for returning Observable from provided fetch and subscribe Network functions (bfc7f7f46427262fac7205b74c03b3ec9cb6fcae)

Fixed:

• Ensure Relay compiler generates the right kinds (db6ef370045538c825331b44fb9a6f20ce3556f2)
• Edge cases when Network cache returns synchronously (2ffb5c663d70bcea052a608c86cad84eef461f1f)
• Incorrect error handling in Networking (63ca3aea9db10e1e85a3f15a959bfa25e7982bf4)
• Ensure logging for each response from a GraphQL Subscription (777bcf64ad0d8c8ccccd7f5cc300f53439038768)
• Ensure the same edge is not added twice during pagination (d0aff0f3ed25899835c0a85b21943a30f848c0fa)

Improved:

• Full support for React v16
• Support root level types that aren't named "Query" in Relay Compat (@robrichard 1544f5907ec134494b7edcfe7d67379c7513e458)
• Improved generated flow types (0d4cf95375d6800ac95edcd0283a689d67b5a95d)
• Support for customized logging (a82a417c78a02db1595a29fe7e1e9d5925cadec2)
• Included a peerDep between relay-runtime and relay-compiler to create early warnings if dependencies are misaligned (25826464fd4e0778e518d417d1ede04686a2ea68)
• Support for flow types for custom scalars (9488a51b51ea5a6d1808654bf83f0050009dabe9)

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

• Experimental @inline directive to inline fragments verbatim for use in utility functions (1b19ee0fb536fd9b28d25fd7b02801256870d68c)
• The compiler now supports --exclude and --include for more control over what files are parsed (94c8b203a95b1366b4034459d1c594e092de92ee)
• PaginationContainer can now refetch with new variables, useful for server filtered, paginated lists (6bc91271f31e5e268784be516ed6c3190d82c89f)

Fixed

• Relay context is set correctly inside pagination containers (@pranaygp, b09bba4512971dc4463cb3fa78cb29c27ba59304)
• Fixed an issue where fragments didn't update correctly when the last item of a plural field was deleted (08336c63c59e9fb8ca398cb019a11e1250c38c61)
• Fixed a bug where query files weren't re-generated if only the flow type changed (697c6ee908602e230cec91f4742f700ea6fd5fc1)

Improved

• Faster parsing in the compiler by caching the extracted graphql tags (7e1065fd6ea2cbc5e3468029ac2f0ab3b7daf418)
• Improved error handling in the compiler (cb7680fff2116e27ffa813a1b486afe713f08c89)
• The callback to loadMore and refetch of the pagination and refetch container is now consistently called after render (e316b6e70c06f03dc4a1160342f1f7c73dc59b20)
• The compiler now parses .js.flow files (3e0266c649e993e704f07bb8484cae8938112a71)
• A new warning on pagination container helps avoid bugs (3fe68c8ba24532b8b2fe3ad6fe5d679186a183e0)
• Better error when unknown directories are inside the generated output directories (9766201c92e546af8f015f62bd68b277d888d5a2)
• Line numbers of parse errors are now correct (ca15340cb4ece8063ec393eb3d37c7792ad6d9d5)
• Updated graphql dependency to ^0.10.5 (beba4077be30c80327d41dc4871c09c4a9bdabb5)

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:

• Polyfills for 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)
• "Soft error mode" is removed from babel-plugin-relay. Previously this would insert throw statements into the compiled output, now this produces compiler errors. (c7634da4453f37b804c14230e920839273421767)
• Optimistic responses from mutations are now expected to be objects (ed5f4f9d3a575236f503778915dcbbf19c8e2440)
• Proper support for component filenames with non alphanum characters may change the names of Components (78ea60b8dd5758188d8bd54cffdc880aea2f61a0)

New:

• Relay containers now accept the prop componentRef to get a ref of the contained component (3571fb9530c5decde1da5ae10fd45179eebc82ba)
• More GraphQL validation rules are caught statically on the client (a85397a994ec899401518c207176071f41c716cc)
• QueryResponseCache added to the public API (00c7e90b4b928607c4db43cf02161e29e6df3800)
• RelayRecordSourceInspector added to the public API (bc81e061c9c2596532a8e4f0e233fc8b9cfab6c1)
• Relay compiler now supports different templates (a66b8b6fac93c23e5d750e20c802e922fbdeee22)
• Tons of improved error messages (#1767, 3236d90216329b7bc50e942ba68dfee84337338b, e54e30797b746b027cc764c81bcda72029980260, 0106f766e2a72b22fb3dc2d9dbae49003462b21a, 7a7387381516064f40475623de903c948ecc7394, 24d35fc6aef8d20771748e89b90cae62c78db37d, ac004422bd63cc841d0d6820c84ea66ec648ca4c, d837abc0804885386c4f6a5c3d79fac636b20c8d, aa78c843124d5a997a4f183b58e7e42b01884198)
• Performance enhancements to relay-compiler (afa874aa7e3e24f87200bc0657239a61d4507805)
• Improved profiling messages (fff1f42e10564cbb419b35645c7040c34e9d03d5)
• Support for GraphQL.js v0.10
• Support for React v16 (1cc7fc7287ed187471b7957dc333e87e45563932, 1adfba2258b4bdbdd40718ba0c7ee257f2dec085)
• Support adding and deleting ranges of a connection from a mutation (4064b9b35918a55f16f5582e47954e0996daf8f6, aefe58056fc4c728d055af548bcb16ec955d914c)
• Generated flow types for mutations (fd4b9e6c10fe219ff3422c704da3f243a4e2e76c)

Fixes:

• Nested Refetch containers now correctly rerender children (#1702)
• Views now re-resolve when query variables change (0bf9bc01d1b2d866d435687fa7c4ff48f2f67fff)
• Live query polling now sends a first request immediately (5e19e83364a6c2900ca5dc116f2ac1ec360ba01f)
• Removed warnings when using custom scalars (296e0b703d5bc8fd556b26dde7094d855367468f)
• Schema without a Viewer type supported correctly (daf38f24b861a76c6acfbd3217e3043a699af991)
• Generated Flow types now respect @relay(plural) (#1810)
• Generated Flow types accept non-strict input (66c3d1d6acf8800c8965fa9fedfcc1f3e1197ec0)
• Watch mode in relay-compiler is more resilient to errors (38707c08c031e40af7a6176fade3213aff549530)
• No longer require a GraphiQL printer within a network logger (#1857)
• Improved flow types for QueryRenderer (#1855)

Introducing Relay Modern

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.

• Read more about today's release.
• Learn more about Relay Modern.
• See an example using Relay Modern.

New in Relay Modern:

• Support for Persisted Queries.
• Simpler imperative mutation API.
• Client schema extensions.
• Flow type generation.
• Support for GraphQL Subscriptions.
• Experimental support for GraphQL Live Queries via polling.
• Fewer requirements around routing.
• Extensible core which can be used independently of React.
• Garbage Collection for minimal memory use.
• Improved runtime performance and smaller bundle (20% the size of Relay Classic).

Get Started with Relay Modern:

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!

Changes since rc.3:

• Support for Relay components in index.js files.
• Support for GraphQL Object and List literals
• Improved error messages
• Support for React v16 alpha builds
• Fixed an issue where not passing a completion callback for pagination could throw an error
• New API: getResponse() on Record Source Proxy objects.
• Ensure compiler-generated files are ignored by eslint
• New: RelayStoreProxyDebugger for debugging a Relay store.
• Much improved generated Flow types now enforce read-only usage of GraphQL results.
• New: exposed retry() method in QueryRenderer ready state

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:

• Fixed most common issue with using RelayModern directly (#1665)
• New API: Environment.check() (1c585b2bdb0fcc375472d585f4f18d42bbbdfbf9)
• Improved generated Flow types
• Internal API: Renamed "RelayStatic" to "RelayModern" in a number of places
• Fixed last warning from using React.PropTypes
• Improvements to 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 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:

• Fixed: relay-compiler --watch now actually watches your files. (#1654)
• Pure Relay Modern (import from 'react-relay') no longer includes any compatibility layer (#1631)
• Allow NonNull types in GraphQL connections (#1637)
• Internally imports prop-types instead of using React.PropTypes to allow using React v15.5 without warnings
• Overhauled flow types in generated files to be more accurate
• Added uploaders API to Network in Relay Modern and Classic.

Introducing Relay Modern

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.

• Read more about today's release.
• Learn more about Relay Modern.
• See an example using Relay Modern.

New in Relay Modern:

• Support for Persisted Queries.
• Simpler imperative mutation API.
• Client schema extensions.
• Flow type generation.
• Support for GraphQL Subscriptions.
• Experimental support for GraphQL Live Queries via polling.
• Fewer requirements around routing.
• Extensible core which can be used independently of React.
• Garbage Collection for minimal memory use.
• Improved runtime performance and smaller bundle (20% the size of Relay Classic).

Get Started with Relay Modern:

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.

Changes since v1.0.0-alpha.3

• Solved a number of bugs when using the relay-compiler binary