Shu Uesugi 6804039e94 Make example READMEs more consistent (#10124 )

* npx create → npm init

* Fix inconsistent instructions

* Update amp-first

* Update with-graphql-react

* with-firebase-cloud-messaging

* Update with-higher-order-component

* change create-next-app url

* Update create-next-app instruction

* Update instructions to use npm instead of npx

* Move "the idea behind the example" to top

* Rename

* Rename

* Update contributing.md with a README template

2020-01-16 23:23:56 +01:00

2.9 KiB

Raw Blame History

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 ZEIT Now:

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/zeit/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 now (download):

now

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.

2.9 KiB Raw Blame History

Next.js example with graphql-react