react-query-mutative

Implement optimistic updates in React Query by applying mutative helpers within the onMutate lifecycle to update the cache immediately, and return previous state snapshots to enable automatic rollback on mutation failure.

Rollback failed mutations in React Query by capturing the previous cache state during onMutate and restoring it inside the onError handler to safely revert optimistic UI updates when the request fails.

Use invalidateQueries to mark query data as stale for passive background refetching, and use refetchQueries when you must actively force a network request immediately following a successful mutation.

Structure query keys for multiple domains using query key factories that consistently derive keys for specific domains and queries, ensuring a scalable API module pattern across your React application.

Your React Query client refetches on window focus because the default configuration overrides mutation behavior. Set refetchOnWindowFocus to false in your QueryClient configuration to prevent overriding optimistic state.