Apollo Router

What it does

This skill generates configuration files for the Apollo Router, a high-performance graph router used to manage GraphQL connections across multiple services when building Apollo Federation 2 supergraphs. It guides users through a series of steps to create version-correct configurations tailored to their specific needs, including selecting the target Apollo Router version (v1 or v2), environment (production or development), and desired features. The skill ensures proper configuration based on these choices.

When to use it

• Creating an initial Apollo Router configuration for a new project.
• Generating configurations for different environments (development vs. production).
• Configuring specific features like JWT Authentication, CORS, operation limits, or Connectors.
• Migrating existing router.yaml files to newer versions.
• When needing help deciding between Apollo Router v1 and v2.

Key capabilities

• Version Selection: Guides users through choosing between Apollo Router v1 and v2, providing recommendations based on use case.
• Environment Configuration: Generates configurations for both production (security-hardened) and development (open defaults) environments.
• Feature Inclusion: Allows selection of features like JWT Authentication, CORS, Operation Limits, Traffic Shaping/Rate Limiting, Telemetry, APQ, Connectors (v2 only), Subscriptions, Header Propagation.
• Parameter Gathering: Collects necessary parameters for each selected feature.
• Connector Support: Provides configuration templates specifically for Apollo Connectors (available in Router v2).

Example prompts

• "Generate an Apollo Router configuration for version 2, development environment."
• "I need a production-ready configuration with JWT authentication and CORS enabled."
• "Which Apollo Router version should I use?"
• “Can you help me upgrade my existing router.yaml?”

Tips & gotchas

• Version Compatibility: Router v1 and v2 have incompatible configuration schemas, so selecting the correct version is crucial.
• Connectors Requirement: Apollo Connectors are only supported in Router v2.
• CORS Security: Avoid using "*" as an allowed origin for CORS in production environments.