rsnext/examples/with-graphql-hooks/README.md
Joe Warren 5fd7b85280 Add graphql-hooks example (#6482)
Adds an example app using [graphql-hooks](https://github.com/nearform/graphql-hooks) that started life as the with-apollo example app. It uses the same graph.cool backend, mostly to demonstrate how similar it is.
2019-03-01 18:21:03 +01:00

1.8 KiB

Deploy to now

GraphQL Hooks Example

This started life as a copy of the with-apollo example. We then stripped out Apollo and replaced it with graphql-hooks. This was mostly as an exercise in ensuring basic functionality could be achieved in a similar way to Apollo. The bundle size of graphql-hooks is tiny in comparison to Apollo and should cover a fair amount of use cases.

Demo

https://next-with-graphql-hooks.now.sh

How to use

Using create-next-app

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

npx create-next-app --example with-graphql-hooks with-graphql-hooks-app
# or
yarn create next-app --example with-graphql-hooks with-graphql-hooks-app

Download manually

Download the example:

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

Install it and run:

npm install
npm run dev
# or
yarn
yarn dev

Deploy it to the cloud with now (download):

now

The idea behind the example

GraphQL Hooks is a library from NearForm that intends to be a minimal hooks-first GraphQL client. Providing a similar API to Apollo.

You'll see this shares the same graph.cool backend as the Apollo example, this is so you can compare the two side by side. The app itself should also look identical.