Principled GraphQL

Shopify GraphQL Design Tutorial

This tutorial provides practical guidance for designing robust GraphQL APIs, distilled from Shopify's extensive experience building and maintaining production schemas. It offers real-world insights that help developers avoid common pitfalls and create scalable, maintainable GraphQL implementations. ## Key Features - **Production-Proven Guidelines** — Based on lessons learned from Shopify's 3+ years of evolving GraphQL schemas in production environments - **Practical Design Patterns** — Concrete recommendations for schema design, naming conventions, and API structure - **Flexible Framework** — Guidelines presented as adaptable principles rather than rigid rules, encouraging thoughtful application - **Community Translations** — Available in multiple languages through community contributions - **Real-World Context** — Includes the rationale behind decisions and acknowledges exceptions to general rules ## Philosophy The tutorial emphasizes practical, experience-based guidance over theoretical perfection, recognizing that most design rules have exceptions and should be applied judiciously based on specific use cases and constraints.

Yelp GraphQL Guidelines

This repo contains documentation and guidelines for a standardized and mostly reasonable approach to GraphQL (at Yelp)

GitLab GraphQL API Style Guide

This document outlines the style guide for the GitLab GraphQL API