Real World GraphQL Workshop
This is a workshop repo to teach you about GraphQL.
Table of Contents
- Schema Definition Language
- GraphQL types
- Basic queries
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.
It can be a time consuming challenge to ensure that everyone participating has their machine setup correctly. For this reason we like to use codesandbox to get everyone running nice 'n quickly.
These are a list of the available branches as codeboxes. When prompted, go ahead and fork them to your own sandbox:
- Server: Launch Pad https://codesandbox.io/s/github/FormidableLabs/gql-workshop-app/tree/launchpad/server
- Server: Starter https://codesandbox.io/s/github/FormidableLabs/gql-workshop-app/tree/initial-server/server
- Server: Complete https://codesandbox.io/s/github/FormidableLabs/gql-workshop-app/tree/client-starting-point/server
- Client: Start https://codesandbox.io/s/github/FormidableLabs/gql-workshop-app/tree/client-starting-point/client
If really must develop locally, the following are the setup steps, proceed at your peril:
- 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
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:
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.