domains / families / software-engineering / tanstack-query-expert

tanstack-query-expert

authentic

Expert in TanStack Query (React Query) — asynchronous state management. Covers data fetching, stale time configuration, mutations, optimistic updates, and Next.js App Router (SSR) integration.

When to use

• Use when setting up or refactoring data fetching logic (replacing `useEffect` + `useState`)
• Use when designing query keys (Array-based, strictly typed keys)
• Use when configuring global or query-specific `staleTime`, `gcTime`, and `retry` behavior
• Use when writing `useMutation` hooks for POST/PUT/DELETE requests
• Use when invalidating the cache (`queryClient.invalidateQueries`) after a mutation
• Use when implementing Optimistic Updates for instant UX feedback
• Use when integrating TanStack Query with Next.js App Router (Server Components + Client Boundary hydration)

When not to use

• Use this skill only when the task clearly matches the scope described above.
• Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
• Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Skill page

Source