rsnext/examples/with-graphql-react/README.md

Next.js example with graphql-react

Deploy your own

Deploy the example using ZEIT Now:

Setup

1. Download the example:

   curl https://codeload.github.com/zeit/next.js/tar.gz/canary | tar -xz --strip=2 next.js-canary/examples/with-graphql-react
   

2. Change directory to it:

   cd with-graphql-react
   

3. Install it:

   npm install
   

4. Run it:

   npm run dev
   

The idea behind the example

graphql-react is a GraphQL client for React using modern context and hooks APIs that is lightweight (< 2.5 KB size limited) but powerful; the first Relay and Apollo alternative with server side rendering.

• In next.config.js Next.js config is decorated using withGraphQLConfig from next-graphql-react, to exclude specific graphql-react and next-graphql-react server only imports from the client bundle.
• In pages/_app.js a custom App component is decorated with the withGraphQLApp higher-order component from next-graphql-react, generating a graphql prop that populates the GraphQLProvider component from graphql-react.
• In pages/index.js the useGraphQL React hook from graphql-react is used to query the GraphQL Pokémon API and show a picture of Pikachu.