GraphQL.org Website Source

SpectaQL is a Node.js library designed to generate static, highly customizable 3-column HTML documentation for GraphQL schemas.

Supported Input Methods:

• Live Endpoint: Uses an introspection query to fetch the schema.
• Introspection File: Uses a file containing the results of an introspection query.
• SDL Files: Uses files, multiple files, or globs pointing to Schema Definition Language (SDL) definitions.

Key Features:

• Generates a single-page 3-column HTML layout.
• Includes built-in themes.
• Highly customizable and themeable, allowing almost any part of the output to be overridden.

Jimmer is an ORM (Object-Relational Mapping) framework designed for Java and Kotlin. It is specifically optimized for handling object trees with arbitrary depth, making it highly compatible with GraphQL's graph-based data model.

Key features include:

• Spring GraphQL Integration: Provides specialized APIs for rapid development of Spring GraphQL-based applications (supported since Spring Boot 2.7).
• Dual Language Support: Offers both Java and Kotlin APIs.
• GraphQL-Friendly Caching: Includes powerful caching mechanisms designed for graph structures.
• Performance: Optimized for speed compared to other popular ORM solutions.
• Deep Object Tree Support: Designed to handle complex queries, updates, and caching for nested object trees rather than just simple, flat objects.

The 2025 refresh of the GraphQL Local Initiative introduces several changes to how local events are supported and managed:

• Event Types: Support is no longer limited to talks. Eligible events now include discussions, workshops, hackathons, Q&As, and live recordings.
• Documentation Requirements: Video recordings are no longer mandatory; photos can be used as substitutes for documentation.
• Increased Funding: Sponsorship per event has increased from USD $200 to USD $400 to assist with venue, food, and drink costs.
• Community Continuity: To prevent meetups from dissolving when organizers step down, a GraphQL TSC member may be appointed as an admin to ensure long-term oversight.

GraphQL Calculator is a lightweight calculation engine designed to alter the execution behavior of GraphQL queries. It allows you to perform field mapping, filtering, and argument transformations directly within your GraphQL queries using specialized directives.

query basicMapValue($userIds: [Int]) {
  userInfoList(userIds: $userIds) {
    id
    age
    firstName
    lastName
    fullName: stringHolder @map(mapper: "firstName + lastName")
  }
}

The ballerina-graphql library provides the following capabilities for building GraphQL services:

• Native Ballerina Integration: Built using the Ballerina service and listener model, treating them as first-class citizens.
• Websocket Subscriptions: Supports GraphQL subscriptions over websockets without requiring additional libraries.
• File Uploads: Built-in support for file upload operations.
• GraphiQL Client: Includes a built-in GraphiQL client for interacting with your services.

GraphQL is a query language for your API and a server-side runtime for executing queries using a type system you define for your data. It is not tied to a specific database or storage engine; instead, it is backed by your existing code and data.

Key characteristics include:

• Type System: You define your API by specifying types and their fields.
• Precise Fetching: Clients can query exactly what they need, receiving data in the expected shape in a single request.
• Evolution without Versioning: You can evolve your API by adding new fields or deprecating old ones using the @deprecated directive, avoiding the need for multiple API versions.

GraphiQL 5 introduces several major improvements:

• Monaco Editor Migration: The default editor is now Monaco (the engine behind VS Code), providing intelligent autocompletion, hover tooltips, go to definition, and find references. Use Cmd (macOS) or Ctrl (Windows/Linux) to click references in the Query editor.
• Command Palette: Press F1 to access available commands, including multiple cursors.
• Comments in Variables and Headers: The Variables and Headers editors now support comments using JSONC. Comments are automatically stripped before the request is executed, so the editor content remains unchanged.
• Updated Shortcuts: The shortcut to focus the Doc Explorer search input is now Cmd/Ctrl+Alt+K (changed from Cmd/Ctrl+K to avoid conflict with Monaco's built-in commands).

Depending on your needs, you can use different types of clients:

• Simple HTTP Clients: Use standard fetch or curl for basic requests.
• Advanced Clients: For complex applications requiring automatic batching and caching, use Relay.
• GUI/Testing Tools: To test queries via a graphical interface, use GraphiQL, Insomnia, or Postman.

The working group is developing several resources for the community to improve AI-driven GraphQL interactions:

• GraphQL writer agent reference implementation: Demonstrates how AI systems construct, validate, and refine GraphQL operations.
• MCP reference implementation/specification: Illustrates GraphQL as a structured protocol for AI-driven systems using the Model Context Protocol.
• Benchmark study: Compares model performance in generating valid GraphQL operations.
• Public benchmark schema and test suite: A shared playground for community experimentation and developing proficient reference agents.

GraphQL is not owned by Facebook. While the specification was originally developed at Facebook, it is now governed by the GraphQL Foundation, a neutral, vendor-neutral organization hosted under the Linux Foundation.

Governance includes:

• Oversight of open-source repositories
• Funding and events
• Technical decision-making via the GraphQL Working Group (WG) and the Technical Steering Committee (TSC)