Over the last few years, I had the chance to work on two of the biggest public GraphQL APIs out there. I’ve observed the good, the bad, and ugly in these GraphQL schemas. The Little Book of GraphQL Schema Design is a collection of learnings on what I have seen work well, and not so well when it comes to designing great GraphQL APIs.
The book will cover how domain driven design can help us build a great GraphQL API, best practices when migrating from other API approaches, common anti-patterns, GraphQL Mutations, evolution of GraphQL schemas, public APIs, and much more.
The book is language agnostic and heavily uses the GraphQL SDL to provide examples. So no matter how you build your GraphQL APIs, it should come in very useful. As this is a subject that evolves a lot, the book will be online, meaning it will be continuously evolved as my learnings continue. It might eventually be available as PDF / paper.
GraphQL being quite a young approach to building APIs, I always found there was a lack of resources on how to design a great schema using GraphQLs type system. I really hope this book can help you all build more expressive GraphQL schemas that are great to use for your integrators and evolve well with time.