Star Wars Demo Application

Overview¶

This application implements a comprehensive GraphQL API for the Star Wars universe, demonstrating how Viaduct handles complex data relationships, advanced resolver patterns, and sophisticated schema design.

Requirements¶

Java 17+ and git (see Project Setup for the full compatibility matrix).
A clone of github.com/viaduct-dev/starwars. Read the repo's README for any framework-specific setup steps.
Linux, Mac, or Windows

What you'll find¶

The Star Wars demo showcases:

Global IDs — Viaduct's identity model and how Node types are referenced.
Node Resolvers — direct object resolution by Global ID.
Field Resolvers — field-level computation and lightweight lookups.
Batch Resolvers — efficient bulk data loading.
Resolver Integration Patterns — how the layers compose at execution time.
Mutations — modifying data through GraphQL mutations.
Variables — dynamic variable provision.
Backing Data — sharing pre-fetched data between sibling resolvers via @backingData.

Getting the Star Wars application¶

git clone https://github.com/viaduct-dev/starwars.git
cd starwars

Running the application¶

Follow the instructions in the repository's README to build and run the application:

./gradlew test
./gradlew run

After exploring the Star Wars application, you'll have a solid understanding of how to build production-ready GraphQL applications with Viaduct.

What's Next¶

Continue to Core Concepts to walk through Viaduct's foundational building blocks as they appear in this demo.