GraphQL Basics

In this workshop you'll build a GraphQL API in Typescript using the SQLite chinook sample database using the following librarys (amongst others):

• Node (runtime)
• Express (web server)
• GraphQL (GraphQL for JavaScript)
• Apollo Server for Express (graphql server middleware)
• GraphQL Tools
• GraphiQL (graphql browser-based IDE)
• node-sqlite (sqlite async client)

Prerequisites

Make sure you're set up before starting the workshop:

1. Recent version of NodeJS
2. Up to date VS Code
3. Extensions for VS Code
   • TSLint
   • Prettier
4. Remove any old typescript SDK entry from your system PATH (put there by old versions of VS).

Workshop Structure

The workshop is split into 5 lessons which should take around 20-30 mins each if you copy and paste code into place and do some reading / thinking / playing along the way.

Branches have been created to capture the completed code at the end of each workshop, and at the end of each step in lesson 4.

If you have problems, just check out the branch corresponding to where you want to be.

e.g.

git checkout lesson2 -f

You may need to also run an npm install after switching branches.

Note: The workshop doc is only included in the master branch, so I suggest reading from the hosted repo rather than from local files.

Branches

If you have problems or need to jump ahead, checkout the complete code for any lesson via the corresponding branch:

• lesson1
• lesson2
• lesson3-start
• lesson3
• lesson4-step1
• lesson4-step2
• lesson4-step3
• lesson4-step4
• lesson5

e.g.

git checkout lesson2 -f

Getting Started

1. Start from scratch, in the almost-empty* master branch:

   git checkout master
   

   *master has a .gitignore and package.json

2. Follow the links to lesson 1 and start writing code!

Lessons

• # 1 - Project Setup & Express Hello World
• # 2 - GraphQL Hello World
• # 3 - Add SQLite to GraphQL API
• # 4 - Add Albums, Tracks and a Mutation
• # 5 - Consuming GraphQL