hackernews-graphql-js

This repository contains the final project for the GraphQL.js tutorial on How to GraphQL. Note that it also serves as foundation for all frontend tutorials on the site.

Usage

1. Clone repository & install dependencies

git clone https://github.com/howtographql/graphql-js
cd graphql-js
yarn install # or `npm install`

2. Deploy the Prisma database service

yarn prisma deploy

When prompted where (i.e. to which cluster) you want to deploy your service, choose any of the public clusters, e.g. public-us1 or public-eu1. (If you have Docker installed, you can also deploy locally.)

Note: This repository uses a slightly outdated version of the Prisma CLI and will be updated soon to use the latest release.

3. Set the Prisma service endpoint

From the output of the previous command, copy the HTTP endpoint and paste it into src/index.js where it's used to instantiate the Prisma binding. You need to replace the current placeholder __PRISMA_ENDPOINT__:

const server = new GraphQLServer({
  typeDefs: './src/schema.graphql',
  resolvers,
  context: req => ({
    ...req,
    db: new Prisma({
      typeDefs: 'src/generated/prisma.graphql',
      endpoint: "__PRISMA_ENDPOINT__",
      secret: 'mysecret123',
    }),
  }),
})

For example:

const server = new GraphQLServer({
  typeDefs: './src/schema.graphql',
  resolvers,
  context: req => ({
    ...req,
    db: new Prisma({
      typeDefs: 'src/generated/prisma.graphql',
      endpoint: "https://eu1.prisma.sh/public-hillcloak-flier-942261/hackernews-graphql-js/dev",
      secret: 'mysecret123',
    }),
  }),
})

Note that the part public-hillcloak-flier-952361 of the URL is unique to your service.

4. Start the server & open Playground

To interact with the API in a GraphQL Playground, all you need to do is execute the dev script defined in package.json: