mattensor/learn-graph

exemplar app for learning graphql

Learn Graph

Welcome to learn graph, a nifty exemplar app to learn graphQL basics

Tutorial

About

GraphQL is a modern query language for your api.

It allows you to ask for anything you want in a single query and can make the domain easy to reason about.

Philosophy

Domain as a Graph

Graphs often resemble our natural world models and they allow a common language to be used with everyone in organisation.

When working with GraphQL you want to model your business domain as a graph.

Schema first

You jump right into implimetation, adding feature after feature. Code is deployed to production and you have many consumers. Soon enough the domain doesn't represent the real world 🔥 and it becomes difficult to change.

Start with schema first. We design the dream query from the clients perspective and this should represent the real world domain. Then we can then dive into the implimentation.

Tools

• Apollo " My favourite GraphQL implimentation"
• typescript "We all love types"
• GraphQL Code Generator "Fantastic project for e2e type safety"
• Express "Our lean Api framework"
• Next.js "Our beautiful Web framework"