ember-apollo-client
An Ember CLI addon for integrating Apollo Client and GraphQL into Ember.js applications.
What is ember-apollo-client?
ember-apollo-client is an Ember CLI addon that integrates Apollo Client and GraphQL into Ember.js applications. It provides tools for querying, mutating, and subscribing to GraphQL APIs, handling data management, caching, and real-time updates while aligning with Ember's conventions and lifecycle patterns.
Ember.js developers building applications that consume GraphQL APIs, particularly those needing robust data fetching, real-time subscriptions, and seamless integration with Apollo Client's ecosystem.
Developers choose ember-apollo-client for its battle-tested reliability in large apps, automatic cleanup of queries and subscriptions, and deep integration with Ember's framework, reducing boilerplate and preventing common GraphQL pitfalls.
Overview
🚀 An ember-cli addon for Apollo Client and GraphQL
Use Cases
Best For
- Integrating GraphQL APIs into Ember.js applications
- Building real-time features with GraphQL subscriptions
- Managing complex data fetching with Apollo Client in Ember
- Server-side rendered Ember apps using FastBoot with GraphQL
- Testing GraphQL operations deterministically in Ember tests
- Using TypeScript with GraphQL imports in Ember projects
Not Ideal For
- Projects not using Ember.js or planning to migrate away from Ember
- Applications requiring frequent inline GraphQL queries without precompilation overhead
- Teams with strict dependencies on Apollo Client v1 or v2, as this addon only supports v3+
- Small prototypes where the setup complexity for subscriptions or custom links outweighs GraphQL benefits
Pros & Cons
Pros
Automatically unsubscribes from watch queries and subscriptions when routes or components are destroyed, preventing memory leaks, as emphasized in the queryManager usage.
Designed to work with Ember's conventions and lifecycle, using computed macros and services to feel native, such as the queryManager decorator for easy data fetching.
Includes deterministic testing utilities with tracked promises, ensuring reliable test suites for GraphQL operations, highlighted in the testing section.
Supports server-side rendering with FastBoot when configured with ssrMode: true, enabling isomorphic Ember apps with GraphQL, as documented.
Provides type definitions for GraphQL imports and Apollo operations, enhancing developer experience in TypeScript projects, with setup instructions in the README.
Cons
Inline queries using graphql-tag are compiled at runtime, which is slower and increases bundle size, as the README warns against using them in favor of external files.
Configuring GraphQL subscriptions requires manual WebSocket link setup and link composition, which can be error-prone and time-consuming, as shown in the examples.
Only compatible with Apollo Client v3 or above, forcing upgrades from older versions and risking breaking changes with future Apollo updates that may require addon updates.
Extending the Apollo service for advanced features like custom links or authentication requires deep knowledge of both Apollo Client and Ember services, complicating initial setup.
Frequently Asked Questions
Related Projects
apollo-clientThe industry-leading GraphQL client for TypeScript, JavaScript, React, Vue, Angular, and more. Apollo Client delivers powerful caching, intuitive APIs, and comprehensive developer tools to accelerate your app development.
relayRelay is a JavaScript framework for building data-driven React applications.
aws-amplifyA declarative JavaScript library for application development using cloud services.
urqlThe highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.