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

Next.js example with graphql-react

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.

Deploy your own

Deploy the example using Vercel:

How to use

Using create-next-app

Execute create-next-app with npm or Yarn to bootstrap the example:

npm init next-app --example with-graphql-react with-graphql-react-app
# or
yarn create next-app --example with-graphql-react with-graphql-react-app

Download manually

Download the example:

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

Install it and run:

npm install
npm run dev
# or
yarn
yarn dev

Deploy it to the cloud with Vercel (Documentation).

Notes

• 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.