At a Glance:
WunderGraph Cosmo is an Apache 2.0 licensed Lifecycle API Management platform purpose-built for Federated GraphQL, providing a unified system that includes a Schema Registry, composition checks, routing, analytics, metrics, and tracing, deployable fully on-premises or as a managed service.
Overview:
WunderGraph Cosmo is a Lifecycle API Management platform designed specifically for Federated GraphQL. It provides a unified system for managing the complete lifecycle of a federated graph by combining a Schema Registry, composition validation, and a router with integrated observability tooling for analytics, metrics, and tracing. The platform is built to accommodate both monolithic and federated GraphQL architectures. Cosmo supports a flexible deployment model, allowing users to run the entire platform on-premises for full data control or use it as a managed service, all under the Apache 2.0 license. It is suited for developers composing schemas locally, architects evaluating platform-level tooling, and platform engineers managing deployments.
Key Decision Points:
Federated GraphQL Lifecycle Management: Cosmo is a dedicated platform for managing the lifecycle of federated graphs, including schema registration and composition checks, not just a standalone router.
Deployment Flexibility: The project explicitly supports 100% on-premises deployment via Docker Compose or Kubernetes through an official Helm chart, alongside a managed service option.
Monolithic and Federated Support: The platform can manage both monolithic and federated GraphQL architectures, providing flexibility if migration to a federated model is a future consideration.
Built-in Observability: Analytics, metrics, and tracing are core components of the platform, not external add-ons, for monitoring the federated graph.
Apache 2.0 Licensing: The entire platform is released under the Apache 2.0 license, allowing for broad use and modification without the constraints of a copyleft license.
Core Features:
Schema Registry: A central registry for managing and validating individual subgraph schemas that compose the federated graph.
Composition Checks: Automated validation of schema compositions to ensure that changes to individual services do not break the unified graph.
Cosmo Router: The runtime component that executes federated GraphQL queries across the combined subgraphs, which has been scaled for high-demand events according to project documentation.
Routed Observability: Integrated analytics, metrics, and tracing capabilities that provide insights into federated query execution and performance.
Federated Subscriptions: Support for real-time data updates in a federated context, with documented implementations using NATS and event-driven architecture.
Use Cases:
Developers composing GraphQL schemas locally can run the Cosmo Router to test a federated graph assembled from multiple services during development.
Platform engineers can deploy the complete Cosmo platform to a Kubernetes cluster for consistent lifecycle management of the organization's federated APIs.
Architects evaluating GraphQL federation tooling can run the entire platform locally with Docker Compose to assess its schema management, routing, and observability capabilities.
Open-Source Alternative Value:
WunderGraph Cosmo offers a self-contained, open-source platform for managing the full lifecycle of a federated GraphQL architecture. Its value as an alternative lies in combining a Schema Registry, composition checks, routing, and built-in observability under a single, permissive Apache 2.0 license. The explicit support for 100% on-premises deployment via Docker Compose or Kubernetes allows organizations to manage their entire federation layer within their own infrastructure without relying on an external managed service for critical control plane functions.
