How to build a custom GraphQL router with graphql-go-tools?

Follow the tutorial in the README, which walks through parsing, normalizing, planning with data sources, and executing GraphQL operations. It requires implementing the DataSource interface and configuration, so be prepared for hands-on Go development.

graphql-go-tools vs Apollo Router: which is better for performance?

graphql-go-tools is benchmarked 8x faster than Apollo Router in throughput and latency for Go-based stacks, but Apollo Router is a ready-to-use solution in Rust. Choose graphql-go-tools for custom, high-performance Go infrastructure, and Apollo Router for a drop-in federation gateway.

Does graphql-go-tools support GraphQL subscriptions over WebSockets?

Yes, it implements GraphQL subscriptions over WebSockets and Server-Sent Events (SSE), with blog posts detailing scaling using epoll/kqueue for real-time applications in federated environments.

Is graphql-go-tools good for beginners in GraphQL?

No, it's a low-level library aimed at experienced Go developers building custom routers or gateways. Beginners should start with higher-level frameworks like gqlgen or use pre-built routers.

How to add a custom data source in graphql-go-tools?

Implement the DataSource interface from the engine/datasource package and configure it in plan.Configuration. The library provides examples for static and GraphQL data sources, but custom ones require Go programming to handle resolution logic.

Can I use graphql-go-tools without Federation?

Yes, it can be used for non-federated GraphQL servers or API gateways, but its strengths are in Federation and advanced features, so it might be overkill for simple GraphQL servers compared to alternatives like gqlgen.

Open-Awesome

graphql-go-tools

MITGov2.1.0

A GraphQL router and API gateway framework written in Go, focusing on correctness, extensibility, and high-performance with Federation support.

Visit Website GitHub

820 stars158 forks0 contributors

What is graphql-go-tools?

GraphQL Go Tools is a Go library for building custom GraphQL routers and API gateways. It provides a complete GraphQL engine with support for Federation, subscriptions, and advanced query planning, enabling developers to create high-performance GraphQL infrastructure tailored to their needs. It solves the problem of needing a flexible, extensible foundation for GraphQL routing beyond off-the-shelf solutions.

Target Audience

Go developers and platform engineers building custom GraphQL routers, API gateways, or federated GraphQL architectures. It's ideal for teams needing fine-grained control over GraphQL execution, performance optimization, and integration with existing infrastructure.

Value Proposition

Developers choose GraphQL Go Tools for its high performance, extensibility, and full Federation support. Unlike generic GraphQL servers, it provides a low-level engine that can be customized for specific use cases, with benchmarks showing significant performance advantages over alternatives like Apollo Router.

Overview

GraphQL Router / API Gateway framework written in Golang, focussing on correctness, extensibility, and high-performance. Supports Federation v1 & v2, Subscriptions & more.

Use Cases

Best For

Building custom GraphQL routers with specific performance requirements
Implementing Apollo Federation v1/v2 in Go-based architectures
Creating API gateways that aggregate multiple GraphQL or REST services
Developing high-throughput GraphQL infrastructure with low latency
Adding GraphQL subscriptions to federated architectures
Extending existing GraphQL servers with custom execution logic

Not Ideal For

Teams needing an out-of-the-box, production-ready GraphQL server with minimal setup
Projects that don't require GraphQL Federation or advanced query planning capabilities
Developers preferring higher-level frameworks with built-in resolvers and tooling
Small-scale applications where a pre-built router like Cosmo Router would be more practical

Pros & Cons

Pros

High Performance Engine

Benchmarked 8x faster than Apollo Router with optimized garbage collection, as shown in internal performance tests and blog posts about scaling for high-throughput events.

Full Federation Support

Supports Apollo Federation v1 and v2, enabling distributed GraphQL architectures with intelligent entity resolution and query planning.

Extensible Data Sources

Flexible system to integrate static data, HTTP APIs, GraphQL APIs, and custom resolvers, allowing tailored backend integrations.

Advanced Query Planning

Includes batching, normalization, and caching strategies for efficient execution, detailed in blog posts on normalization and data loading algorithms.

Cons

Complex Setup and Boilerplate

Requires significant code to build a basic router, as shown in the lengthy tutorial with multiple steps for parsing, normalizing, planning, and executing.

Not Production-Ready Out of the Box

The provided federation example is explicitly stated as not production-ready, pushing users towards Cosmo Router for a complete solution.

Vendor Lock-in and Commercial Focus

Heavily tied to WunderGraph's ecosystem with emphasis on commercial support, which may limit community-driven features and independence.

Open Source Alternative To

graphql-go-tools is an open-source alternative to the following products:

Apollo Router

Apollo Router is a high-performance GraphQL federation runtime that composes multiple GraphQL services into a single unified graph.

Frequently Asked Questions

Related Projects

Prisma

Next-generation ORM for Node.js & TypeScript | PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, MongoDB and CockroachDB

Stars45,872

Forks2,183

Last commit3 days ago

Bit

AI-powered development workspaces with reusable components, architectural clarity and zero overhead.

Amplication brings order to the chaos of large-scale software development by creating Golden Paths for developers - streamlined workflows that drive consistency, enable high-quality code practices, simplify onboarding, and accelerate standardized delivery across teams.

Stars15,996

Forks1,550

Last commit10 days ago

graphql-code-generator

A tool for generating code based on a GraphQL schema and GraphQL operations (query/mutation/subscription), with flexible support for custom plugins.

Stars11,237

Forks1,390

Last commit17 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub