This is a workshop repo to teach you about GraphQL.
Table of Contents
Server
- Schema Definition Language
- GraphQL types
- Resolvers
- Enums
- Scalars
- DataLoader
- Mutations
Apollo Client
- Basic queries
- Fragments
- Pagination
- Auth
- 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.
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
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.
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:
server
client
Each folder contains a package.json
and will require a yarn install
to be run in the package root.
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.
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.