Skip to main content

The Graph Handbook

MAXKING's open catalogue of GraphQL & federation knowledge — schema best practices, federation gotchas we've hit in production, and full case studies. Written from real incidents in large-scale, high-traffic environments, not from vendor docs.

What's inside

  • Best Practices — schema design, pagination, error handling, versioning, security, caching. The patterns that survive contact with dozens of teams and millions of users.
  • Federation Best Practices — how to design, govern and operate a supergraph: subgraph boundaries, schema governance & CI, router operations, client experience.
  • Federation Gotchas — the sharp edges of Apollo Federation and supergraph architectures: entity ownership fights, composition failures, gateway-level N+1s.
  • Case Studies — end-to-end write-ups of real engagements: what the problem was, what we did, what it cost, what it returned.

Who this is for

Engineers and architects building or operating GraphQL at any scale — from your first schema to a 40-subgraph supergraph. Everything here is opinionated, and every opinion was paid for in production.

:::tip Work with us Need hands-on help with your graph? See our Graph Health Check and Federation practice or email hello@maxking.com.au. :::