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
- The registry displays the most recent successfully composed schema for your federated graph.
- Both the Router Schema, used for query planning and including @inaccessible fields, and the Client Schema, exposed via introspection, are accessible.
- A subgraph dropdown lets you view any individual subgraph schema from the same interface.
- Copy schemas to the clipboard or download them as
.graphqlfiles for code generation and documentation tools. - 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
- Router Schema — used for query planning; includes @inaccessible fields needed for federation resolution.
- Client Schema — the schema exposed via introspection.
- Subgraph schemas — each individual subgraph schema, accessible via dropdown.
- Last-updated timestamps — every schema view shows when it last changed.
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
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.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.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.Download as a .graphql file
Download the schema as a.graphqlfile for code generation tools or API documentation generators like GraphQL Voyager and SpectaQL.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
- You need the current production schema for code generation or documentation tools.
- You want to understand how a type is defined across subgraphs.
- You need to verify when the schema last changed.
Requirement
- The federated graph needs at least one successful composition. The registry displays the latest successfully composed schema, so there is no current schema to show until composition succeeds.
Always-current schemas for your whole team
Free tier. No credit card. Schema Registry included from day one.