GraphQL Editor LogoTry GraphQL Editor

A better way to stitch GraphQL schemas

July 11, 2019 by Tomek

Schema is the most important part of any GraphQL implementation. Schema is a centerpiece of any GraphQL service and defines the data-sets that can be queried by the client.

What’s a schema stitching?

Imagine having a project where multiple teams are involved in each team:

  • handles different aspects crucial to that service,
  • has to work on the schema to make sure that their part of the project would work as expected,
  • must make sure that everything would work properly as a whole.

Cooperating on a huge project schema might be confusing…

What's going on in this schema

A piece of GitHub’s schema containing 9182 lines of code in total!

Schema stitching is a process of merging multiple GraphQL schemas into one that can be queried. It’s an incredibly useful approach when it comes to building projects that require having both, unified & transparent access to a data split across multiple APIs (even without understanding where exactly it’s located). It can be also used to customize an existing GraphQL API like adding custom resolvers or overriding existing ones of third-party GraphQL service or adding more fields to an existing type whose data comes from another data source.

Two schemas merged

Performing a schema stitching can cause troubles

Although putting two schemas into one in a way where there are no name collisions seems quite simple, but that’s not a real schema stitching. What we want to achieve is one consistent schema, merged from multiple underlying GraphQL APIs. That’s a way more difficult, but what if a told you that there is an app for that?

A better way

The latest release of GraphQL Editor introduced an easy way to collaborate on schemas. All we need to do is:

1. Add two or more schemas to our account - you can load them from URL or .gql file

Add some schemas to GraphQL Editor

2. Initiate a new project GraphQL Editor

3. Pick schemas we want to have access to in our newly generated schema from the list & create a project Stitching Two Schemas in GraphQL Editor

and that’s it!

As long as we have managed to avoid conflicts between our underlying schemas, we should have access to all their elements in our newly generated project 👌

Now you have access to all elements of merged schema

Speed up your GraphQL API development

The GraphQL Editor is a supportive tool for both advanced GraphQL users as well as those taking their first steps with GraphQL APIs. Our all-in-one development environment for GraphQL will help you build, manage & deploy your GraphQL API much faster thanks to dozens of built-in micro features. Its graphical interface will also fix communication within your product team. Visualization is the key!

Try it for free

Tomek Poniatowicz
Written by Tomek Poniatowicz GraphQL enthusiast. Magic the Gathering fanatic. Pizza monster. email me:[email protected]Twitter Shield
← Back to blog


© Copyright 2018