Start with the query your consumer would write if there were no constraints, then work backwards. A practical guide to consumer-first GraphQL schema design.

Wundergraph is a blog or publication focused on GraphQL, a query language and runtime for APIs. Through tutorials, guides, and case studies, Wundergraph explores various aspects of GraphQL development, including schema design, query optimization, and integration with frontend frameworks. Developers can learn how to leverage GraphQL to build efficient and flexible APIs that meet the needs of modern web and mobile applications.

WunderGraph

Most APIs are designed backend-first, exposing database fields rather than consumer needs. The 'dream query' approach flips this: ask consumers what query they'd write with no constraints, then work backwards to design the schema. This means resolving relationships (returning a Department object instead of a departmentId), computing fields consumers actually need (displayName instead of firstName+lastName), and omitting fields nobody asked for. The process involves identifying gaps between the dream query and the current supergraph, designing schema changes, and decomposing responsibilities across subgraph teams. This approach surfaces cross-team dependencies before implementation and produces APIs that reflect consumer intent rather than implementation details. The method works without special tooling but WunderGraph Hub is presented as a platform to automate and collaborate on this workflow.

The Dream Query: Consumer-First GraphQL API Design