Gradual GraphQL Adoption Strategies

Embracing GraphQL Gradually

Introducing GraphQL into existing large codebases can be a daunting task. It requires careful planning and execution to ensure that the transition is smooth and beneficial. A key strategy is to adopt GraphQL gradually and in a distributed manner, which allows for more controlled integration and minimizes disruption.

By starting with small dependencies on the client side, teams can begin to see immediate benefits without overhauling the entire system. This approach allows developers to learn and adapt to GraphQL's advantages while maintaining the existing architecture. Over time, as understanding deepens and benefits become clear, more significant components can be transitioned to GraphQL.

The Power of The Guild's Tooling

The Guild, a prominent open-source group, has developed several tools to aid in the gradual integration of GraphQL. These tools include the GraphQL Code Generator, GraphQL Inspector, and GraphQL Mesh, each serving a unique purpose in the ecosystem. They are designed to be used individually or together, providing flexibility in how they are adopted.

GraphQL Mesh, for example, allows developers to query non-GraphQL sources as if they were GraphQL. This means that existing REST, SOAP, or gRPC services can be integrated into a GraphQL environment without modifying the backend. This capability makes it easier for organizations to adopt GraphQL without needing to rewrite existing services.

Contributing to the GraphQL Ecosystem

Contributing to the broader GraphQL community is vital for maintaining a robust and healthy ecosystem. By participating in initiatives like the migration of GraphQLJS to TypeScript or improving GraphQL.org's infrastructure, developers can help ensure that these core components continue to evolve and improve.

The Guild encourages community involvement, whether through code contributions or feedback on existing projects. Their commitment to open-source development and collaboration has led to significant advancements in GraphQL tooling and documentation.

Exploring New Developments

The GraphQL community is constantly evolving, with new libraries and directives being developed to address emerging needs. For instance, the introduction of the GraphQL Web Socket library has made it easier to implement subscriptions securely and efficiently.

Directives like stream and defer have also been incorporated into the GraphQL specification, offering more control over data fetching. These developments demonstrate the community's commitment to addressing real-world challenges and enhancing the capabilities of GraphQL.

Schema Stitching vs. Apollo Federation

When it comes to merging multiple GraphQL sources, developers have options. While Apollo Federation is a popular choice, Schema Stitching remains a powerful alternative. Both approaches have their benefits, and choosing between them depends on the specific needs of a project.

The Guild has continued to support and improve Schema Stitching, providing a viable option for those who require its flexibility. This ongoing support ensures that developers can choose the best tool for their situation without being locked into a single solution.

Leveraging GraphQL Mesh for Integration

GraphQL Mesh is a versatile tool that simplifies the integration of various data sources. By converting existing schemas into GraphQL, it allows developers to query data from multiple sources seamlessly. This capability is particularly useful for organizations with diverse data ecosystems.

With GraphQL Mesh, developers can create a unified data layer that aggregates information from different services. This approach not only streamlines data access but also reduces the complexity of managing multiple APIs.

Building a Distributed GraphQL Infrastructure

A distributed GraphQL infrastructure offers several advantages, including increased resilience and scalability. By avoiding a single point of failure, organizations can ensure that their systems remain robust and responsive.

GraphQL Mesh and Schema Stitching facilitate this distributed approach by allowing services to operate independently while still providing a cohesive graph. This setup enables organizations to maintain flexibility and adaptability as their needs evolve.

The Role of a Central Registry

To manage a distributed GraphQL infrastructure effectively, a central registry plays a crucial role. This registry acts as a repository for schemas, allowing developers to track and manage changes across the ecosystem.

GraphQL Hive is an example of such a registry. It enables developers to store and retrieve schema information easily, facilitating the generation of SDKs and other integrations. By decoupling schema management from runtime execution, developers can maintain a clean and organized system.

Ensuring a Smooth Transition

Successful GraphQL adoption hinges on adopting the right tools and strategies at the right time. By focusing on a gradual and distributed approach, organizations can mitigate risks and maximize the benefits of GraphQL.

This strategy allows teams to build on existing knowledge and infrastructure, ensuring a smoother transition and greater long-term success. By leveraging the tools and insights available within the GraphQL community, developers can make informed decisions that align with their goals and objectives.

Invitation to Collaborate

The continuous improvement of GraphQL tools and practices relies on community collaboration. Developers are encouraged to contribute their ideas, feedback, and expertise to drive the ecosystem forward.

The Guild's commitment to open-source development highlights the importance of collaboration in fostering innovation. By working together, developers can create a more powerful and versatile GraphQL landscape that benefits everyone.

Watch full talk with demos and examples:

This ad is not shown to multipass and full ticket holders
JSNation US
JSNation US 2025
November 17 - 20, 2025
New York, US & Online
See JS stars in the US biggest planetarium
Learn More
In partnership with Focus Reactive
Upcoming event
JSNation US 2025
JSNation US 2025
November 17 - 20, 2025. New York, US & Online
Learn more
Rate this content
Bookmark

From Author:

During our work with many different clients from all shapes and sizes, The Guild had to come up with all kinds of innovative solutions to help customers achieve the most out of GraphQL and help adopt it more easily. During that talk I will mention how you could use GraphQL in places you though it wasn’t possible, share open source tools to help you and provide new perspectives about why GraphQL is a great technology.

This talk has been presented at GraphQL Galaxy 2020, check out the latest edition of this Tech Conference.

Watch video on a separate page

FAQ

Uli is a member of The Guild, the largest open source group in the GraphQL world. He gave the first talk at GraphQL Galaxy.

The Guild is the largest open source group in the GraphQL community, responsible for maintaining popular libraries like GraphQL Code Generator, GraphQL Inspector, GraphQL Modules, GraphQL Tools, and GraphQL Mesh.

The Guild provides several tools including GraphQL Code Generator, GraphQL Inspector, GraphQL Modules, GraphQL Tools, and GraphQL Mesh, among others.

GraphQL Hive is a registry for different GraphQL schemas and sources. It helps in organizing and managing schemas from various sources and is used to generate SDKs for distributed query execution.

Apollo Federation is a technique to merge multiple GraphQL sources into one, but The Guild maintains and improves Schema Stitching as an alternative. Schema Stitching allows merging GraphQL sources and non-GraphQL sources, providing flexibility and customization options.

Yes, GraphQL Mesh allows you to specify custom sources and create custom transforms, giving you full control over the conversion, execution, and merging processes.

The Guild believes in a gradual and distributed approach to adopting GraphQL. They emphasize using tools and solutions only when needed and ensuring that these tools can be integrated gradually without a complete buy-in to a specific ecosystem.

You can contribute to The Guild's projects by visiting their GitHub repositories, joining their forum, or participating in their online chat. They welcome community feedback and contributions to improve their open-source projects.

GraphQL Mesh allows you to query sources that are not GraphQL as if they were GraphQL automatically. It can convert various data sources like OpenAPI, gRPC, SOAP, SQL, and OData into GraphQL schemas.

The Guild has joined the GraphQL Foundation to help influence and contribute to the core assets of GraphQL, such as GraphQLJS and GraphQL.org. They are involved in migrating GraphQLJS to TypeScript and improving the GraphQL.org infrastructure.

Uri Goldshtein
Uri Goldshtein
34 min
02 Jul, 2021

Comments

Sign in or register to post your comment.
Video Summary and Transcription
The talk covers the journey of The Guild, the largest open-source group in the GraphQL world, highlighting their contributions and tools like GraphQL Code Generator, GraphQL Inspector, and GraphQL Mesh. GraphQL Mesh allows converting non-GraphQL sources such as OpenAPI, Swagger, and SQL into GraphQL, making it easier to query these sources. Schema Stitching is discussed as a flexible alternative to Apollo Federation, enabling the merging of multiple GraphQL schemas. The talk also mentions GraphQL Web Socket library for integrating subscriptions, and GraphQL Helix for lightweight framework needs. The Guild's contributions to the GraphQL Foundation, including migrating GraphQLJS to TypeScript and rebuilding GraphQL.org using Gatsby, are highlighted. GraphQL Hive is introduced as a registry to manage different GraphQL schemas, promoting a distributed approach to GraphQL integration without a central gateway.

1. Introduction to The Guild and Its Tools

Hi everyone, my name is Uli and I'm really excited to be here and give the first talk at GraphQL Galaxy. I'm a member of a group called The Guild. We're the largest open source group in the GraphQL world. We have developed various tools like the GraphQL Code Generator, GraphQL Inspector, GraphQL Modules, GraphQL Tools, and GraphQL Mesh. These tools help in generating code, tracking changes, splitting responsibilities, and querying non-GraphQL sources.

2. GraphQL Foundation and Contributions

In the last year, we joined the GraphQL Foundation to influence and contribute to GraphQLJS and GraphQL.org. We're migrating GraphQLJS to TypeScript and need help with that. We've rebuilt GraphQL.org using Gatsby, making it easier to contribute and find well-maintained libraries. It's now easier than ever to contribute.

3. Exciting Developments and Introducing GraphQL

I'll mention some exciting developments in the GraphQL community, including new libraries and directives. We're thrilled about the GraphQL Web Socket library, which makes integrating subscriptions and Web Socket protocols easier than ever. Liliana and Rob have worked hard to bring the stream and defer directives into the spec, and the Live Queries directive, created by Lauren, shows promise. We also recommend GraphQL Helix, a lightweight framework developed by Daniel, and appreciate the work Riqui has done on GraphiQL and GraphQL language services. We want to support individuals in the community and are here to help and collaborate. Now, let's dive into the actual talk on introducing GraphQL into large codebases and share our lessons and toolings. GraphQL is a powerful tool for describing and querying data.

4. Integrating GraphQL into Services and Backend

In this example, the GraphQL engine orchestrates multiple calls for the client, providing a simplified experience. By introducing GraphQL on the client, we can automate manual work and gradually move the orchestration to the server. We can also integrate GraphQL into backend services by converting existing services or generating GraphQL schemas from existing sources. This is where GraphQL Mesh comes in, automatically converting information into GraphQL.

5. GraphQL Mesh: Converting and Merging Sources

GraphQL Mesh allows you to convert various sources like OpenAPI, Swagger, gRPC, SOAP, SQL, and OData into GraphQL. It enables querying GraphQL without the sources being aware of it, making adoption easier. GraphQL Mesh also allows merging multiple GraphQL and non-GraphQL sources into one GraphQL source. The community offers Apollo Federation as a solution for merging GraphQL sources, but with GraphQL Mesh, you have the choice to use Apollo Federation or Schema Stitching. Schema Stitching, often considered deprecated, is still a viable alternative to Apollo Federation and offers even more flexibility. With GraphQL Mesh, you can use Schema Stitching with any GraphQL source, allowing you to leverage the benefits of GraphQL without being tied to a specific ecosystem or product.

6. GraphQL Mesh and Distributed GraphQL

You can use GraphQL merging and remote sources without buying into a specific product. Check out the schema stitching demos repository by Greg to see demos of the latest schema stitching and compare them with Apollo Federation. With GraphQL Mesh and schema stitching, you can get all the benefits of a central place to query with one graph, but without the need for a central gateway. Instead, you can generate SDKs and have each service query directly. This makes GraphQL Mesh a powerful gateway and a better data source. It can be integrated into existing GraphQL services, providing a distributed solution with one-graph information. The registry is the missing piece to save all the schemas from different sources.

7. GraphQL Hive and Distributed Workflow

We just need a place for all those different services to register and say, hey, this is my schema. Today we are already having that registry running at all of our clients. It's something that we're going to open source. It's called GraphQL Hive. So again, the idea of the GraphQL Hive is that all of the different tools that I just mentioned today are working separately, but if you want to get the benefits of all of those together, you can have it in a registry. So for us, just to summarize everything I said today, the GraphQL workflow is the most important thing. What is the workflow that GraphQL enables us and then we can choose the toolings that we want and we can use them gradually, and where we want in a distributed way. We want to execute anywhere. We still want the one graph. We still want to look at all of organization and we want to order what's all the mess that is happening, so we can still collect all those schemas and we can put it in a registry like GraphQL Hive. And again, without the need to put them together in the runtime, so we don't have a central point of failure, we still get the benefits of the order. We can start enforcing rules. We can start enforcing rules and have best practices around all over the company, again, without making people running through a central gateway. Same goes for tracing, by the way, and visibility. You know, once we have all those different environments running, we can gather all the data individually from each of those different sources. We can store it anywhere inside your existing tools today, because you probably already are doing it.

8. Introducing GraphQL and Distributed Approach

You can visualize your existing tools centrally by connecting them to GraphQL Inspector and GraphQL Hive. You don't need to conform to one ecosystem, as you can convert non-GraphQL sources into GraphQL using GraphQL Mesh. This allows you to gradually introduce GraphQL and avoid early adoption of solutions that may not be beneficial in the long run. We believe in a distributed and gradual approach, where you only adopt what you need when you need it. For more information and to provide feedback, visit gil.dev.

QnA

Schema Stitching and Q&A

The answer is basically, it's not deprecated. Apollo Federation was good for many use cases, but not all. We still needed to support schema stitching for our clients. Since we took over, schema stitching has evolved a lot and is now a powerful alternative to Apollo Federation. We give you the option to choose between the new schema stitching and Apollo Federation. When given the choice, more and more people are choosing schema stitching. So, it's not deprecated at all and it's better than ever. Regarding the Q&A, a question was asked about Mesh doing one-on-one conversion, and the answer is yes, and more.

Mesh Conversion and Customization

Mesh allows you to convert and join different end points, even if they come from different services. You have full control over the conversion, execution, and merging processes. It has become a valuable gateway product with extensive customization options.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

From GraphQL Zero to GraphQL Hero with RedwoodJS
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
From GraphQL Zero to GraphQL Hero with RedwoodJS
Top Content
Tom Pressenwurter introduces Redwood.js, a full stack app framework for building GraphQL APIs easily and maintainably. He demonstrates a Redwood.js application with a React-based front end and a Node.js API. Redwood.js offers a simplified folder structure and schema for organizing the application. It provides easy data manipulation and CRUD operations through GraphQL functions. Redwood.js allows for easy implementation of new queries and directives, including authentication and limiting access to data. It is a stable and production-ready framework that integrates well with other front-end technologies.
Local State and Server Cache: Finding a Balance
Vue.js London Live 2021Vue.js London Live 2021
24 min
Local State and Server Cache: Finding a Balance
Top Content
This Talk discusses handling local state in software development, particularly when dealing with asynchronous behavior and API requests. It explores the challenges of managing global state and the need for actions when handling server data. The Talk also highlights the issue of fetching data not in Vuex and the challenges of keeping data up-to-date in Vuex. It mentions alternative tools like Apollo Client and React Query for handling local state. The Talk concludes with a discussion on GitLab going public and the celebration that followed.
Batteries Included Reimagined - The Revival of GraphQL Yoga
GraphQL Galaxy 2021GraphQL Galaxy 2021
33 min
Batteries Included Reimagined - The Revival of GraphQL Yoga
Envelope is a powerful GraphQL plugin system that simplifies server development and allows for powerful plugin integration. It provides conformity for large corporations with multiple GraphQL servers and can be used with various frameworks. Envelope acts as the Babel of GraphQL, allowing the use of non-spec features. The Guild offers GraphQL Hive, a service similar to Apollo Studio, and encourages collaboration with other frameworks and languages.
Rock Solid React and GraphQL Apps for People in a Hurry
GraphQL Galaxy 2022GraphQL Galaxy 2022
29 min
Rock Solid React and GraphQL Apps for People in a Hurry
The Talk discusses the challenges and advancements in using GraphQL and React together. It introduces RedwoodJS, a framework that simplifies frontend-backend integration and provides features like code generation, scaffolding, and authentication. The Talk demonstrates how to set up a Redwood project, generate layouts and models, and perform CRUD operations. Redwood automates many GraphQL parts and provides an easy way for developers to get started with GraphQL. It also highlights the benefits of Redwood and suggests checking out RedwoodJS.com for more information.
Adopting GraphQL in an Enterprise
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
Adopting GraphQL in an Enterprise
Today's Talk is about adopting GraphQL in an enterprise. It discusses the challenges of using REST APIs and the benefits of GraphQL. The Talk explores different approaches to adopting GraphQL, including coexistence with REST APIs. It emphasizes the power of GraphQL and provides tips for successful adoption. Overall, the Talk highlights the advantages of GraphQL in terms of efficiency, collaboration, and control over APIs.
Step aside resolvers: a new approach to GraphQL execution
GraphQL Galaxy 2022GraphQL Galaxy 2022
16 min
Step aside resolvers: a new approach to GraphQL execution
GraphQL has made a huge impact in the way we build client applications, websites, and mobile apps. Despite the dominance of resolvers, the GraphQL specification does not mandate their use. Introducing Graphast, a new project that compiles GraphQL operations into execution and output plans, providing advanced optimizations. In GraphFast, instead of resolvers, we have plan resolvers that deal with future data. Graphfast plan resolvers are short and efficient, supporting all features of modern GraphQL.

Workshops on related topic

Build a Headless WordPress App with Next.js and WPGraphQL
React Summit 2022React Summit 2022
173 min
Build a Headless WordPress App with Next.js and WPGraphQL
Top Content
Workshop
Kellen Mace
Kellen Mace
In this workshop, you’ll learn how to build a Next.js app that uses Apollo Client to fetch data from a headless WordPress backend and use it to render the pages of your app. You’ll learn when you should consider a headless WordPress architecture, how to turn a WordPress backend into a GraphQL server, how to compose queries using the GraphiQL IDE, how to colocate GraphQL fragments with your components, and more.
Build with SvelteKit and GraphQL
GraphQL Galaxy 2021GraphQL Galaxy 2021
140 min
Build with SvelteKit and GraphQL
Top Content
Workshop
Scott Spence
Scott Spence
Have you ever thought about building something that doesn't require a lot of boilerplate with a tiny bundle size? In this workshop, Scott Spence will go from hello world to covering routing and using endpoints in SvelteKit. You'll set up a backend GraphQL API then use GraphQL queries with SvelteKit to display the GraphQL API data. You'll build a fast secure project that uses SvelteKit's features, then deploy it as a fully static site. This course is for the Svelte curious who haven't had extensive experience with SvelteKit and want a deeper understanding of how to use it in practical applications.

Table of contents:
- Kick-off and Svelte introduction
- Initialise frontend project
- Tour of the SvelteKit skeleton project
- Configure backend project
- Query Data with GraphQL
- Fetching data to the frontend with GraphQL
- Styling
- Svelte directives
- Routing in SvelteKit
- Endpoints in SvelteKit
- Deploying to Netlify
- Navigation
- Mutations in GraphCMS
- Sending GraphQL Mutations via SvelteKit
- Q&A
Relational Database Modeling for GraphQL
GraphQL Galaxy 2020GraphQL Galaxy 2020
106 min
Relational Database Modeling for GraphQL
Top Content
Workshop
Adron Hall
Adron Hall
In this workshop we'll dig deeper into data modeling. We'll start with a discussion about various database types and how they map to GraphQL. Once that groundwork is laid out, the focus will shift to specific types of databases and how to build data models that work best for GraphQL within various scenarios.
Table of contentsPart 1 - Hour 1      a. Relational Database Data Modeling      b. Comparing Relational and NoSQL Databases      c. GraphQL with the Database in mindPart 2 - Hour 2      a. Designing Relational Data Models      b. Relationship, Building MultijoinsTables      c. GraphQL & Relational Data Modeling Query Complexities
Prerequisites      a. Data modeling tool. The trainer will be using dbdiagram      b. Postgres, albeit no need to install this locally, as I'll be using a Postgres Dicker image, from Docker Hub for all examples      c. Hasura
Build and Deploy a Backend With Fastify & Platformatic
JSNation 2023JSNation 2023
104 min
Build and Deploy a Backend With Fastify & Platformatic
Top Content
WorkshopFree
Matteo Collina
Matteo Collina
Platformatic allows you to rapidly develop GraphQL and REST APIs with minimal effort. The best part is that it also allows you to unleash the full potential of Node.js and Fastify whenever you need to. You can fully customise a Platformatic application by writing your own additional features and plugins. In the workshop, we’ll cover both our Open Source modules and our Cloud offering:- Platformatic OSS (open-source software) — Tools and libraries for rapidly building robust applications with Node.js (https://oss.platformatic.dev/).- Platformatic Cloud (currently in beta) — Our hosting platform that includes features such as preview apps, built-in metrics and integration with your Git flow (https://platformatic.dev/). 
In this workshop you'll learn how to develop APIs with Fastify and deploy them to the Platformatic Cloud.
Building GraphQL APIs on top of Ethereum with The Graph
GraphQL Galaxy 2021GraphQL Galaxy 2021
48 min
Building GraphQL APIs on top of Ethereum with The Graph
Workshop
Nader Dabit
Nader Dabit
The Graph is an indexing protocol for querying networks like Ethereum, IPFS, and other blockchains. Anyone can build and publish open APIs, called subgraphs, making data easily accessible.

In this workshop you’ll learn how to build a subgraph that indexes NFT blockchain data from the Foundation smart contract. We’ll deploy the API, and learn how to perform queries to retrieve data using various types of data access patterns, implementing filters and sorting.

By the end of the workshop, you should understand how to build and deploy performant APIs to The Graph to index data from any smart contract deployed to Ethereum.
Hard GraphQL Problems at Shopify
GraphQL Galaxy 2021GraphQL Galaxy 2021
164 min
Hard GraphQL Problems at Shopify
Workshop
Rebecca Friedman
Jonathan Baker
Alex Ackerman
Théo Ben Hassen
 Greg MacWilliam
5 authors
At Shopify scale, we solve some pretty hard problems. In this workshop, five different speakers will outline some of the challenges we’ve faced, and how we’ve overcome them.

Table of contents:
1 - The infamous "N+1" problem: Jonathan Baker - Let's talk about what it is, why it is a problem, and how Shopify handles it at scale across several GraphQL APIs.
2 - Contextualizing GraphQL APIs: Alex Ackerman - How and why we decided to use directives. I’ll share what directives are, which directives are available out of the box, and how to create custom directives.
3 - Faster GraphQL queries for mobile clients: Theo Ben Hassen - As your mobile app grows, so will your GraphQL queries. In this talk, I will go over diverse strategies to make your queries faster and more effective.
4 - Building tomorrow’s product today: Greg MacWilliam - How Shopify adopts future features in today’s code.
5 - Managing large APIs effectively: Rebecca Friedman - We have thousands of developers at Shopify. Let’s take a look at how we’re ensuring the quality and consistency of our GraphQL APIs with so many contributors.