idkjs/gql-workshop-app

Real World GraphQL

Real World GraphQL Workshop

This is a workshop repo to teach you about GraphQL.

Table of Contents

• Topics covered
• Branches & Tags
• System Requirements
• Setup
• Running the app
• About the app

Topics covered

Server

1. Schema Definition Language
2. GraphQL types
3. Resolvers
4. Enums
5. Scalars
6. DataLoader
7. Mutations

Apollo Client

1. Basic queries
2. Fragments
3. Pagination
4. Auth
5. Mutations

There is way more that we could cover, time permitting, but this is broadly what we'll be focussing on. Depending on the flow of the day, we may have more or less time available and the material will adjust to suit.

Branches & Tags

You may notice a number of tags and branches peppered throughout the supporting repo. The workshop steps are tagged such that, if needed, we can skip through to completed examples. The required tag will be documented at the beginning of each section.

System Requirements

• git v2.14.1 or greater
• NodeJS v8.9.4 or greater
• yarn v1.3.0 or greater
• GraphQL Playground recommended
• Apollo Dev Tools for Chrome recommended

All of these must be available in your PATH. To verify things are set up properly, you can run this:

git --version
node --version
yarn --version

If you have trouble with any of these, learn more about the PATH environment variable and how to fix it here for windows or mac/linux.

Setup

Once you've verified that your system is setup correctly. Go ahead and clone our workshop project.

git clone https://github.com/imranolas/moviedb.git
cd moviedb

You should see 2 folders:

1. server
2. client

Each folder contains a package.json and will require a yarn install to be run in the package root.

Running the app

To get the app up and running, run yarn start in both roots.

This will start the GQL server, and the client server in development mode.

About the app

This app is based on the The MovieDB API. It consists of a GraphQL service that wraps the MovieDB API and serves it to the React client app. This is the completed example but we will be starting from a minimal bootstrapped starting point via git tag.