graphql-schema-design

name	graphql-schema-design
description	Design production-grade GraphQL schemas with best practices and patterns
sasmp_version	1.3.0
bonded_agent	02-graphql-schema
bond_type	PRIMARY_BOND
version	2.0.0
complexity	intermediate
estimated_time	3-5 hours
prerequisites	["graphql-fundamentals"]

GraphQL Schema Design Skill

Architect scalable, maintainable GraphQL APIs

Overview

Learn industry-standard patterns for designing GraphQL schemas that scale. Covers naming conventions, pagination, error handling, and schema evolution.

---

Quick Reference

Pattern	When to Use	Example
Connection	Paginated lists	users: UserConnection!
Payload	Mutation results	CreateUserPayload
Input	Mutation args	CreateUserInput
Interface	Shared fields	interface Node { id: ID! }
Union	Multiple types	SearchResult = User | Post

---

Core Patterns

1. Naming Conventions

# Types: PascalCase
type User { }
type UserProfile { }

# Fields: camelCase
type User {
  firstName: String!
  lastName: String!
  createdAt: DateTime!
  isActive: Boolean!      # Boolean prefix: is, has, can
}

# Queries: noun (singular/plural)
type Query {
  user( ID User           
   UserConnection         



  
  createUser CreateUserInput CreateUserPayload
  updateUser ID,  UpdateUserInput UpdateUserPayload
  deleteUser ID DeleteUserPayload

  
  sendEmail SendEmailInput SendEmailPayload
  publishPost ID PublishPostPayload



 CreateUserInput  
 UpdateUserInput  
 UserFilterInput  


 CreateUserPayload  
 UpdateUserPayload