Core Concepts

This section explains how Viaduct's core building blocks — schemas, resolvers, scopes, Global IDs, and batching — map onto the Star Wars demo application. The demo is split across two tenants (universe and filmography); each tenant owns part of the schema and the resolver code that backs it, and they compose into one runnable server. Throughout this section we use minimal in-memory data so the patterns are easy to see and adapt to real backends later.

Topics in this section

The Kotlin and Java applications use the same GraphQL concepts and SDL layout. Java resolvers return CompletableFuture and use types from viaduct.java.api and viaduct.java.grts; Kotlin resolvers use suspending functions and viaduct.api. Select either tab to follow the same sequence in your language.

• Global IDs
• Node Resolvers
• Field Resolvers
• Batch Resolvers
• Named Fragments
• GraphQL Operations
• Resolver Integration Patterns