GraphQL Subgraph API — Spring Boot 3.4 Architecture Blueprint

Scaffold production-ready GraphQL Subgraph API for Spring Boot 3.4: Schema-first GraphQL federation with @QueryMapping, @MutationMapping, DataLoader batching, and GraphiQL playground. Pre-wired JPA, starters, and Docker Compose.

Overview & Architecture Pattern

Schema-first GraphQL federation with @QueryMapping, @MutationMapping, DataLoader batching, and GraphiQL playground.

Architecture Pattern: Web & APIs

Primary Use Case: Flexible frontend querying, Backend-for-Frontend (BFF), mobile client payload optimization.

Included Dependencies & Starters

spring-boot-starter-web, spring-boot-starter-graphql, data-jpa, postgresql

Domain Entities & Scaffolding Defaults

Author (name, bio), Book (title, isbn, pageCount, author)

Quickstart: Running Your Project

# 1. Start required infrastructure containers
docker compose up -d

# 2. Run the Spring Boot 3.4 application (Maven)
./mvnw spring-boot:run

# Or run with Gradle
./gradlew bootRun

Frequently Asked Questions

What starters are included in the GraphQL Subgraph API blueprint?
The GraphQL Subgraph API blueprint includes spring-boot-starter-web, spring-boot-starter-graphql, data-jpa, postgresql, pre-configured application.yml properties, and production-ready connection pools.
How do I run the generated GraphQL Subgraph API project locally?
Extract the downloaded ZIP, start dependencies with 'docker compose up -d', and execute './mvnw spring-boot:run' (Maven) or './gradlew bootRun' (Gradle).
Can I customize entities and database schemas in this blueprint?
Yes, SpringForge allows you to visually add or modify JPA entities, field types, validation rules, and relational mappings, or import SQL DDL schemas.