tanstack-react-query-mutations

Optimistic updates with TanStack Query mutations are implemented using the onMutate lifecycle to update the cache immediately, onSuccess to confirm changes, and onError to roll back if the server request fails.

Error rollback in React Query useMutation is handled within the onError callback by invalidating the query cache or restoring the previous query data captured during onMutate, ensuring UI consistency after failures.

Yes, these mutation patterns support both SSR with TanStack Start and SPA with TanStack Router, applying consistent cache invalidation and optimistic update workflows across create, update, and delete operations.

List and detail caches stay in sync after a React Query mutation by triggering query invalidation in the onSettled or onSuccess callbacks, forcing TanStack Query to refetch the updated data from the API layer.

TanStack Query optimistic updates disappear on error because the onError lifecycle triggers a rollback to the previous cache state, undoing the speculative onMutate changes when the API mutation request fails.

Yes, you need a configured API layer and an established UI integration pattern alongside TanStack Query to handle data fetching and ensure deterministic behavior and graceful recovery from failures.