tanstack-integration-best-practices

Setting up TanStack Query SSR hydration involves dehydrating the query cache on the server and rehydrating it on the client. This guide provides standardized patterns for wiring per-request QueryClient instances into router context to ensure consistent data flow.

The best way to coordinate data fetching between TanStack Router and React Query is to use rule-based loader patterns. This guide offers clear guidance on fetching within loaders, managing suspense patterns, and synchronizing cache invalidation across multi-route scenarios.

Centralized caching and cache invalidation across complex TanStack Router scenarios are handled by enforcing consistent data flow patterns. This guide outlines strategies for coordinating cache invalidation and managing data fetching across multiple routes and components.

This guide applies primarily to new TanStack Start projects, SSR setups, and complex routing scenarios. It focuses on standardizing patterns for wiring QueryClient instances, SSR hydration, and coordinated caching across the stack for these specific use cases.

A per-request QueryClient is needed in TanStack Query SSR setups to ensure isolated cache state for each user. Using a shared client can leak sensitive data between requests, so standardizing per-request instances prevents cross-request data contamination.