spring-graphql

Build Spring GraphQL servers with schema resources and annotated mappings.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/ririnto/sinon --skill spring-graphql
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spring-graphql
Source: https://github.com/ririnto/sinon/tree/main/plugins/spring/skills/spring-graphql
Command: npx skills add https://github.com/ririnto/sinon --skill spring-graphql

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Build Spring GraphQL servers using a schema-first approach with schema resources, annotated query or mutation mappings, batching, transport-aware execution, and GraphQlTester-based tests.

Core Features & Use Cases

  • Schema resources and annotated mapping for GraphQL endpoints in Spring
  • Support for batching and transport-aware execution
  • GraphQlTester-based tests to verify queries and mutations against the schema

Quick Start

Define a Spring Boot app with a GraphQL schema, implement @QueryMapping/@MutationMapping controllers, and run GraphQlTester-based tests.

Frequently Asked Questions about spring-graphql

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Spring Boot GraphQL server with schema and controllers?

Spring GraphQL servers use a schema-first approach with schema resources and annotated @QueryMapping or @MutationMapping controllers. You define the schema files, implement the controller mappings, and verify behavior using GraphQlTester-based tests against the defined endpoints.

How do I test Spring GraphQL queries and mutations over HTTP or WebSocket?

Spring GraphQL provides GraphQlTester-based tests to verify queries and mutations against the schema. It supports transport-aware execution across HTTP or WebSocket transports, allowing you to validate controller mappings and batching of resolvers within your Spring Boot project.

What dependencies do I need for Spring Boot GraphQL endpoints?

You need the Spring Boot GraphQL dependency stack, specifically spring-boot-starter-graphql and graphql-test. These dependencies provide the required schema resources, annotated mapping support, and GraphQlTester-based testing capabilities for your Spring Boot application.

How does batching work for GraphQL resolvers in Spring?

Batching for GraphQL resolvers in Spring groups multiple data requests into a single batch to optimize transport-aware execution. This pattern is supported within Spring Boot projects using annotated query and mutation mappings to efficiently resolve data for GraphQL endpoints.

Can I use a schema-first approach with Spring GraphQL?

Yes, Spring GraphQL supports a schema-first approach. You define schema resources and then implement the schema using annotated @QueryMapping and @MutationMapping controllers in your Spring Boot project, enabling structured endpoint creation and integrated testing.

Why is my Spring GraphQL mutation not returning the expected schema response?

Spring GraphQL mutations must align with schema resources and annotated @MutationMapping controllers. Mismatches between the schema definition and the controller mapping cause unexpected responses, which you can identify and verify by running GraphQlTester-based tests against the schema.