apollo-client README

The project's README from github.com/apollographql/apollo-client. As one markdown file: README.md.

Apollo Logo

Apollo Client

The 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.

➡️ Get Started with Apollo Client →

npm version Build Status Join the community

❓ Why Choose Apollo Client?

✅ Zero-config caching - Intelligent caching out of the box
✅ Framework agnostic - Works with React, Vue, Angular, Svelte, and vanilla JavaScript
✅ TypeScript-first - Full type safety and IntelliSense support
✅ React 19 ready - Supports Suspense, RSC, Compiler, and more
✅ Production-tested - Powers countless apps worldwide that serve millions of end users

🚀 Quick Start

npm install @apollo/client graphql

Apollo Client Skill

Give your AI agent specialized Apollo Client knowledge and setup guidance:

npx skills add apollographql/skills --skill apollo-client

💡 Resources

Resource Description Link
Getting Started Guide Complete setup and first query Start Here →
Full Documentation Comprehensive guides and examples Read Docs →
API Reference Complete API documentation Browse API →
VS Code Extension Enhanced development experience Install Extension →
DevTools Debug your GraphQL apps Chrome | Firefox
Free Course Learn GraphQL and Apollo Client Take Course →

💬 Get Support

Need help? We're here for you:

🧑‍🚀 About Apollo

Deliver tomorrow's roadmap today with our comprehensive suite of API orchestration tools:

Explore the Complete Apollo Platform →

🛠️ Maintained by

Name Username
Jeff Auriemma @bignimbus
Jerel Miller @jerelmiller
Lenz Weber-Tronic @phryneas

Versioning Policy

While Apollo Client follows SemVer, it might introduce changes like changing transpilation targets, updating dependencies or dropping support for older versions of dependencies in minor releases. For more details, see our Versioning Policy.

🗺️ Roadmap

We regularly update our public roadmap with the status of our work-in-progress and upcoming features.

📣 Tell us what you think

☑️ Apollo Client User Survey
What do you like best about Apollo Client? What needs to be improved? Please tell us by taking a one-minute survey. Your responses will help us understand Apollo Client usage and allow us to serve you better.

🗓️ Events

Join these live events to meet other GraphQL users and learn more:

🎪 Apollo Summit 2026 Oct 6-8, 2026 • San Francisco
1000+ engineers, talks, workshops, and office hours

View All Events →

🏆 Contributing

Thank you for your interest in submitting a Pull Request to Apollo Client! Read our guidelines first, and don't hesitate to get in touch.

New to open source? Check out our Good First Issues to get started.

🤝 Code of Conduct

Please read our Code of Conduct. This applies to any space run by Apollo, including our GitHub repositories, the Apollo GraphOS Discord, the Apollo GraphQL Forum. The Code of Conduct reflects our commitment to making the Apollo Community a welcoming and safe space in which individuals can interact.

🪪 License

Source code in this repository is available under the terms of the MIT License. Read the full text here.

apollo-client (apollographql/apollo-client)

Searching Database…

What is this?Apollo Client is a GraphQL client library for JavaScript and TypeScript apps, providing caching, data fetching, and state management for apps built with React, Vue, Angular, or vanilla JS.
Is it a framework or a library?It's a library you add to an existing JS/TS app, not a standalone framework; it's framework-agnostic and works alongside React, Vue, Angular, Svelte, or plain JavaScript.
How do I add it to a project?Install it from npm and follow the Getting Started guide to run your first query; there's also a Quick Start section in the README.
Do I need a GraphQL server already running?Not stated explicitly, but Apollo Client talks to a GraphQL endpoint, so you need a GraphQL API (your own, or composed via Apollo Connectors/Router) to query against.
Any gotchas with versioning or upgrades?Apollo Client follows SemVer but may still change transpilation targets or drop support for older dependency versions in minor releases, so minor upgrades can occasionally break things.
What makes Apollo Client's caching special?It offers zero-config, intelligent caching out of the box, so you don't have to manually set up a normalized cache to get fast, consistent data across your app.
Is it ready for the latest React features?Yes, Apollo Client is React 19 ready and supports Suspense, React Server Components (RSC), and the React Compiler.
Are there dev tools to debug queries?Yes, there's a browser DevTools extension available for both Chrome and Firefox to inspect and debug your GraphQL app's cache and queries.
How does Apollo Client fit with other Apollo products?It's one piece of a broader platform that includes Apollo Connectors (combine GraphQL/REST APIs), Apollo Router (GraphQL Federation), Apollo MCP Server, and GraphOS for managing APIs.
Size
101.2 MB
Stars
19.8K
Age
10y
Commits · 90 Days