moonhighway/schema-design-workshop

The Schema Design Workshop is a training course repository that teaches you how to design GraphQL schemas, the blueprints that describe what data an API exposes and how clients can interact with it. It is a companion repo for a workshop led by Eve Porcello through Moon Highway Training. GraphQL is a query language for APIs that lets front-end applications request exactly the data they need. A schema defines the types, fields, and relationships available. This repo gives workshop participants a single place to find course slides, sample schemas, and a hands-on schema project. The project is built around a Pet Library API, which you can work on in your own code editor or in an online sandbox that requires no setup. The schema evolves through stages, starting from a basic version and building toward a complete one. The audience is developers learning GraphQL, particularly those who want to move beyond basic queries and think about how to structure an API that other teams can use effectively. A product manager or founder exploring GraphQL might also find the sample schemas useful for understanding what a well-designed API looks like. The included examples, a ski resort API, a camp API, and a countries API, give concrete starting points for practice. The repo also touches on federated schemas, where multiple separate APIs are combined into a single gateway that clients can query as one unified service. This is an increasingly common pattern at companies with many teams and services. Beyond the project itself, the repo curates external resources like a cheat sheet, a book on production-ready GraphQL, and real-world style guidelines from Yelp, helpful references for anyone looking to understand what good schema design looks like in practice.