dev.apollodata.comIntroduction to Apollo Client - Apollo GraphQL Docs

Docs Search Apollo (Cmd+K or /) Launch GraphOS Studio Welcome Home Odyssey Tutorials SDKs Apollo Server Client (React) Client (Kotlin) Client (iOS) GraphOS Get started Graph Essentials Schema Pipeline Explorer IDE Metrics & Reporting Org Management Federation Rover CLI Cloud Router Self-Hosted Router Enterprise Features Tech Notes Client (React) v3 v3 v2 Introduction Why Apollo Client? Get started Changelog Fetching Queries Suspense Mutations Refetching Subscriptions Fragments Directives Error handling Document transforms Best practices Caching Overview Configuration Reading and writing Garbage collection and eviction Customizing field behavior Memory Management Advanced topics Pagination Overview Core API Offset-based Cursor-based keyArgs Local State Overview Local-only fields Reactive variables Client-side schema Local resolvers Development & Testing Developer tools Using TypeScript Testing React components Schema-driven testing Mocking schema capabilities Reducing bundle size Performance Improving performance Optimistic mutation results Server-side rendering Compiling queries with Babel Integrations Using Apollo Client with your view layer Integrating with React Native Loading queries with Webpack Networking Basic HTTP networking Advanced HTTP networking Authentication Migrating Migrating to Apollo Client 3.0 Hooks migration guide API Reference Core ApolloClient InMemoryCache ObservableQuery React Hooks Preloading Testing SSR Components (deprecated) HOC (deprecated) Apollo Link Overview HTTP HTTP Batch Context Error Persisted Queries Remove Typename REST Retry Schema Subscriptions (newer protocol) WebSocket (older protocol) Community links Navigation controls Introduction to Apollo Client Apollo Client is a comprehensive state management library for JavaScript. It enables you to manage both local and remote data with GraphQL . Use it to fetch, cache, and modify application data, all while automatically updating your UI. Apollo Client helps you structure code in an economical, predictable, and declarative way that’s consistent with modern development practices. The core @apollo/client library provides built-in integration with React, and the larger Apollo community maintains integrations for other popular view layers . Get started! Core features Some of Apollo Client ’s core capabilities include: Declarative data fetching: Write a query and receive data without manually tracking loading states. Normalized request and response caching: Boost performance by responding almost immediately to queries with cached data. Excellent developer experience: Enjoy helpful tooling for TypeScript, Chrome / Firefox devtools, and VS Code. Designed for modern React: Take advantage of the latest React features, such as hooks and Suspense. Incrementally adoptable: Drop Apollo Client into any JavaScript app and incorporate it feature by feature. Universally compatible: Use any build setup and any GraphQL API. Community driven: Share knowledge with thousands of developers in the GraphQL community. GraphOS supported features Apollo Client works seamlessly with these GraphOS router supported features: Receiving data for specific fields incrementally with the @defer directive Real-time updates via GraphQL subscriptions Safelisting with persisted queries ⓘ NOTE Apollo Client also supports @defer and GraphQL subscription implementations outside of GraphOS . Recommended docs After you get started , check out the full Apollo Client documentation in the navigation on the left. We recommend the following articles in particular: Queries and Mutations . These are the read and write operations of GraphQL . Caching overview . Apollo Client ’s normalized cache enables you to skip network requests entirely when data is already available locally. Managing local state . Apollo Client provides APIs for managing both remote and local data, enabling you to consolidate all of your application’s state. Basic HTTP networking . Learn how to send custom headers and other authentication metadata in your queries. Testing React components . Test your GraphQL operations without requiring a connection to a server. Community integrations This documentation set focuses on React, but Apollo Client supports many other libraries and languages: JavaScript Angular Vue Svelte Solid.js Ember Meteor (thanks to DDP-Apollo ) Web Components Apollo Elements Native mobile Native iOS with Swift Native Android with Java and Kotlin Next Why Apollo Client? On this page Core features GraphOS supported features Recommended docs Community integrations Edit on GitHub Edit Forums Discord © 2024 Apollo Graph Inc. Privacy Policy Company About Apollo Careers Partners Resources Blog Tutorials Content Library Get in touch Contact Sales Contact...