Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Architecture
  3. Data Fetching

Data Fetching

Apollo Client patterns and data loading strategies.

Quick Reference

Use Apollo Client for:

  • GraphQL queries and mutations
  • Automatic request deduplication
  • Client-side caching
  • Optimistic updates

Key patterns:

  • useQuery for data fetching (not useEffect + fetch)
  • useMutation for data updates
  • Multiple useQuery hooks run in parallel automatically
  • Apollo cache shared across component instances

Apollo Client Basics

useQuery for Fetching

useMutation for Updates

Automatic Deduplication

Apollo automatically deduplicates identical queries:

Parallel Queries

Multiple useQuery hooks run in parallel automatically:

Skip Queries Conditionally

Polling

Optimistic Updates

Cache Updates

Error Handling

Lazy Queries

Fetching in Components vs Hooks

In Components (Simple)

In Hooks (Reusable Logic)

Event Listener Deduplication

Share global event listeners across component instances:

Caching Strategies

Cache-First (Default)

Network-Only (Fresh Data)

Cache-and-Network (Background Refresh)

Related Documentation

  • GraphQL Operations - Query/mutation patterns
  • Pub/Sub - GraphQL subscriptions
  • Eliminating Waterfalls - Parallel queries

Reference Files

For more detailed technical guidance, see these reference files:

  • client-graphql-patterns.md
  • client-event-listeners.md
  • client-passive-listeners.md

Previous

Architecture / File Organization

Next

Working on features / Component Patterns

On this page

Quick Reference
Apollo Client Basics
useQuery for Fetching
useMutation for Updates
Automatic Deduplication
Parallel Queries
Skip Queries Conditionally
Polling
Optimistic Updates
Cache Updates
Error Handling
Lazy Queries
Fetching in Components vs Hooks
In Components (Simple)
In Hooks (Reusable Logic)
Event Listener Deduplication
Caching Strategies
Cache-First (Default)
Network-Only (Fresh Data)
Cache-and-Network (Background Refresh)
Related Documentation
Reference Files