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.