Apollo is a GraphQL client that allows you to easily query the exact data you need from a GraphQL server. In addition to fetching and mutating data, Apollo analyzes your queries and their results to construct a client-side cache of your data, which is kept up to date as further queries and mutations are run, fetching more results from the server.
In this simple example, we integrate Apollo seamlessly with Next by wrapping our pages/index.js inside a higher-order component (HOC). Using the HOC pattern we're able to pass down a central store of query result data created by Apollo into our React component hierarchy defined inside each page of our Next application.
On initial page load, while on the server and inside getInitialProps, we invoke the Apollo method, getDataFromTree. This method returns a promise; at the point in which the promise resolves, our Apollo Client store is completely initialized.
In addition to this, we configure our apollo client to work with subscription on the client-side and ensures that only subscription operations are made through websockets.
To see a working example of this, navigate to the Subscription-example page and open up the url in two browsers. Submit a link in the first browser and check the other browser, you'd see the newly submitted link show up instantly without your need to refresh the page.
This example relies on graph.cool for its GraphQL backend.
Note: Do not be alarmed that you see two renders being executed. Apollo recursively traverses the React render tree looking for Apollo query components. When it has done that, it fetches all these queries and then passes the result to a cache. This cache is then used to render the data on the server side (another React render). https://www.apollographql.com/docs/react/api/react-ssr/#getdatafromtree
Deploy the example using Vercel:
_Live Example: https://with-apollo-subscription.now.sh/subscription
Execute create-next-app with npm or Yarn to bootstrap the example:
npm init next-app --example with-apollo-subscription with-apollo-subscription-app
# or
yarn create next-app --example with-apollo-subscription with-apollo-subscription-appDownload the example:
curl https://codeload.github.com/zeit/next.js/tar.gz/canary | tar -xz --strip=2 next.js-canary/examples/with-apollo-subscription
cd with-apollo-subscriptionInstall it and run:
npm install
npm run dev
# or
yarn
yarn devDeploy it to the cloud with Vercel (Documentation).