react-query-mutative

What problem does it solve?

Efficiently manage optimistic UI updates and data consistency in React applications by providing structured mutative utilities and QueryClient configuration guidance.

Core Features & Use Cases

• Centralized QueryClient configuration with deterministic behavior (staleTime: Infinity, gcTime: Infinity, refetchOnMount: false, refetchOnWindowFocus: false, retry: false) and toast-based error handling for mutations and queries.
• Query Key factories to consistently derive keys for domains and queries.
• Mutative helpers for optimistic updates, add/remove, and safe rollback semantics in mutations.
• Clear guidance on invalidateQueries vs refetchQueries and when to use each.
• Scalable API module pattern across domains.

Quick Start

Use mutative helpers to apply optimistic updates during a mutation and automatically rollback on error.