GraphQL Schema Registry | Cosmo by WunderGraph - WunderGraph

The current production schema, always in one place

The Schema Registry keeps your composed federated graph schema and individual subgraph schemas in Studio. View, copy, or download the current schema for code generation, documentation, and debugging.

Always current. View the federated schema or select any subgraph schema. Copy or download in one click.

Why finding the right schema is harder than it should be

In a distributed GraphQL architecture, schemas are scattered across multiple repositories and services. Getting an accurate view of the current production schema takes more effort than it should.

Schemas are scattered across repositories and services

There is no single place to see the complete API surface. Developers can end up working with outdated schemas or missing type definitions.

No authoritative view of the federated graph

The composed federated graph schema is hard to find without a central registry. Developers looking for type definitions across subgraphs have to piece information together from multiple sources, with no guarantee they are looking at the current production schema.

Local development can drift from production

Code generation and documentation tools need an accurate schema file. Without a central registry, teams rely on manually managed schema files that can drift from the current production schema.

One source of truth for every GraphQL schema

The Schema Registry keeps your composed federated graph schema and individual subgraph schemas in Studio. Developers can view the current schema, copy it, or download it for use with development tools.

What the registry gives you

  1. The registry displays the most recent successfully composed schema for your federated graph.
  2. Both the Router Schema, used for query planning and including @inaccessible fields, and the Client Schema, exposed via introspection, are accessible.
  3. A subgraph dropdown lets you view any individual subgraph schema from the same interface.
  4. Copy schemas to the clipboard or download them as .graphql files for code generation and documentation tools.
  5. Last-updated timestamps show when schemas changed.

Before & After

Before Cosmo With Cosmo
Schemas scattered across repositories Single source of truth in Studio
Unclear which schema version is active Current production schema always visible
Manual schema file management One-click copy or download
No easy visibility into subgraph schemas View any subgraph schema in Studio

Every schema view you need

Always know what your graph looks like

Every benefit below is available on the Free tier.

One place for the federated schema and every subgraph schema

The registry gives you the composed federated graph schema and each individual subgraph schema in Studio. No need to check multiple repositories or services to find the current schema.

Always reflects the latest successful composition

The registry updates when composition succeeds. What you see is the latest successfully composed schema, not a stale local copy or manually maintained file.

Copy or download in one click

Copy the schema to your clipboard or download it as a .graphql file. Use it with code generation tools or documentation generators.

View any subgraph schema without leaving Studio

A dropdown selector lets you view any individual subgraph schema. Use it to understand how types and fields are defined across services.

Timestamps show when the schema last changed

Each schema view includes a last-updated timestamp, so developers can see when the schema changed and whether they are looking at the current version.

How to use the Schema Registry

  1. Open Schema Registry in Studio
    Open the Schema Registry in Studio. The registry displays the most recent successfully composed schema for your federated graph in SDL format.

  2. Switch between schema views
    Use the subgraph dropdown to view any individual subgraph schema. The registry also provides access to both the Router Schema and the Client Schema.

  3. Copy to clipboard
    Copy the schema directly to your clipboard for use in development tools or documentation. The copied schema reflects the latest successfully composed version in the registry.

  4. Download as a .graphql file
    Download the schema as a .graphql file for code generation tools or API documentation generators like GraphQL Voyager and SpectaQL.

  5. Check the last-updated timestamp
    Each schema view shows a last updated timestamp. Use it to see when the schema changed and confirm you are working from the current version.

Use cases

Development environment setup

A new developer needs the current production schema for code generation. They open Studio, navigate to the Schema Registry, and download the federated graph schema as a .graphql file. Their local development environment matches production exactly with minimal setup time.

Debugging type definitions

A frontend developer needs to understand how a type is defined and which subgraph owns it. They view the federated schema for the complete type definition, then use the subgraph dropdown to check each relevant subgraph's contribution to that type.

API documentation

A technical writer needs to document the current API for external consumers. They open the Schema Registry, copy the complete federated schema, and use it as the source for API documentation tools. The documentation is generated from the authoritative schema source, not a manually maintained copy.

When to use the Schema Registry

When to use

Requirement

Always-current schemas for your whole team

Free tier. No credit card. Schema Registry included from day one.