Integrating with React Native

You can use Apollo Client with React Native exactly as you do with React.js. Install it with npm like so:

1
npm install @apollo/client graphql

Then wrap your application in the ApolloProvider component, like so:

1
import React from 'react';
2
import { AppRegistry } from 'react-native';
3
import { ApolloClient, InMemoryCache, ApolloProvider } from '@apollo/client';
4

5
// Initialize Apollo Client
6
const client = new ApolloClient({
7
  uri: 'http://localhost:4000/graphql',
8
  cache: new InMemoryCache()
9
});
10

11
const App = () => (
12
  <ApolloProvider client={client}>
13
    <MyRootComponent />
14
  </ApolloProvider>
15
);
16

17
AppRegistry.registerComponent('MyApplication', () => App);

For more information on setting up Apollo Client, see

Example application

Apollo Client Devtools

1. Using

React Native Debugger

The React Native Debugger supports the

1. Install React Native Debugger and open it.
2. Enable "Debug JS Remotely" in your app.
3. If you don't see the Developer Tools panel or the Apollo tab is missing from it, toggle the Developer Tools by right-clicking anywhere and selecting Toggle Developer Tools.

2. Using

Flipper

A community plugin called

1. Install Flipper and open it.

2. Go to add plugin and search for react-native-apollo-devtools and install it

3. Add react-native-flipper and react-native-apollo-devtools-client as dev dependecy to react native app.

4. Initialize the plugin with flipper on client side

   TypeScript

   1
   import { apolloDevToolsInit } from 'react-native-apollo-devtools-client';
   2
   
   3
     const client = new ApolloClient({
   4
       // ...
   5
     });
   6
   
   7
     if (__DEV__) {
   8
       apolloDevToolsInit(client);
   9
     }

   Copy

Consuming multipart HTTP via text streaming

By default, React Native ships with a fetch implementation built on top of XHR that does not support text streaming.

For this reason, if you are using either

1. Install react-native-fetch-api and react-native-polyfill-globals and save them both as dependencies.
2. In your application's entrypoint (i.e. index.js, App.js or similar), import the following three polyfills and call each of the polyfill* functions before any application code:

1
import { polyfill as polyfillEncoding } from "react-native-polyfill-globals/src/encoding";
2
import { polyfill as polyfillReadableStream } from "react-native-polyfill-globals/src/readable-stream";
3
import { polyfill as polyfillFetch } from "react-native-polyfill-globals/src/fetch";
4

5
polyfillReadableStream();
6
polyfillEncoding();
7
polyfillFetch();

3. Finally, there’s a special option we’ll need to pass to our polyfilled fetch. Create an HttpLink so we can set the following on our default fetchOptions:

1
const link = new HttpLink({
2
  uri: "http://localhost:4000/graphql",
3
  fetchOptions: {
4
    reactNative: { textStreaming: true },
5
  },
6
});

Now you're ready to use @defer and/or multipart subscriptions over HTTP in your React Native app!

Troubleshooting

• Uncaught Error: Cannot read property 'prototype' of undefined, or similar Metro build error when importing from @apollo/client

This is due to the way

1
const { getDefaultConfig } = require('@expo/metro-config');
2

3
const config = getDefaultConfig(__dirname);
4

5
config.resolver.sourceExts.push(
6
  'cjs'
7
);
8

9
module.exports = config;