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…

19.8K ·GitHub
Apollo-client
这是什么？Apollo Client 是一个用于 JavaScript 和 TypeScript 应用的 GraphQL 客户端库，为使用 React、Vue、Angular 或原生 JS 构建的应用提供缓存、数据获取和状态管理功能。
它是框架还是库？它是一个可以添加到现有 JS/TS 应用中的库，而不是独立的框架；它与框架无关，可以和 React、Vue、Angular、Svelte 或原生 JavaScript 一起使用。
怎样把它添加到项目中？通过 npm 安装，然后按照入门指南运行你的第一个查询；README 中也有快速开始部分。
我需要先运行一个 GraphQL 服务器吗？文档中没有明确说明，但 Apollo Client 需要与 GraphQL 端点通信，因此你需要有一个 GraphQL API 来执行查询（可以是你自己的，也可以通过 Apollo Connectors/Router 组合而成）。
版本管理或升级方面有哪些需要注意的坑？Apollo Client 遵循 SemVer，但在次要版本中仍可能更改转译目标或停止支持较旧的依赖版本，因此次要版本升级偶尔可能导致问题。
Apollo Client 的缓存有什么特别之处？它开箱即用，提供零配置的智能缓存，因此无需手动设置规范化缓存，就能在整个应用中获得快速且一致的数据。
它支持最新的 React 功能吗？支持。Apollo Client 已适配 React 19，并支持 Suspense、React Server Components（RSC）和 React Compiler。
有用于调试查询的开发者工具吗？有。提供适用于 Chrome 和 Firefox 的浏览器开发者工具扩展，可用于检查和调试 GraphQL 应用的缓存与查询。
Apollo Client 与其他 Apollo 产品是什么关系？它是更大平台中的一部分，该平台还包括 Apollo Connectors（整合 GraphQL/REST API）、Apollo Router（GraphQL Federation）、Apollo MCP Server，以及用于管理 API 的 GraphOS。
What are similar projects?feathers, rxdb, boneyard, pragmatic-drag-and-drop, query, apollo-server, shepherd, sweetalert2
Which topics is it in?angular, graphql, caching, javascript-library, vue, rest-api, react, frontend, api, nodejs, library, typescript
Creator
apollographql
Size
101.2 MB
Stars
19.8K
Updated
CommitOct 16Release@apollo/[email protected]Oct 16
Age
10y
Commits · 90 Days