From tanstack-query
TanStack Query(React Query) ๋ฒ ์คํธ ํ๋ํฐ์ค ๊ฐ์ด๋. useQuery, useSuspenseQuery, useMutation ํ ์ฌ์ฉ, ์๋ฌ ํธ๋ค๋ง(ErrorBoundary, QueryErrorResetBoundary), Query Key Factory ํจํด, Cache Invalidation ์ ๋ต, SSR Prefetch ํจํด ์์ฑ ์ ์ฌ์ฉ. TanStack Query ๊ด๋ จ ์ฝ๋ ์์ฑ์ด๋ ๋ฐ์ดํฐ ํ์นญ ๋ก์ง ๊ตฌํ ์ ์ฐธ์กฐ.
npx claudepluginhub window-ook/claude-code-lab --plugin tanstack-queryThis skill uses the workspace's default tool permissions.
**Version:** 5.x (v5)
PRACTICES.mdPRINCIPLES.mdreferences/api-reference/01-query-client.mdreferences/api-reference/02-query-cache.mdreferences/api-reference/03-mutation-cache.mdreferences/api-reference/04-query-observer.mdreferences/api-reference/05-infinite-query-observer.mdreferences/api-reference/06-queries-observer.mdreferences/api-reference/07-streamed-query.mdreferences/api-reference/08-focus-manager.mdreferences/api-reference/09-online-manager.mdreferences/api-reference/10-notify-manager.mdreferences/api-reference/11-timeout-manager.mdreferences/api-reference/12-use-query.mdreferences/api-reference/13-use-queries.mdreferences/api-reference/14-use-infinite-query.mdreferences/api-reference/15-use-mutation.mdreferences/api-reference/16-use-is-fetching.mdreferences/api-reference/17-use-is-mutating.mdreferences/api-reference/18-use-mutation-state.mdGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Generates or updates index.md listing all files and subdirectories in a target folder with 3-10 word descriptions from file contents. Use for indexing documentation directories.
Version: 5.x (v5) Doc Source: Official TanStack Query documentation
Always read first: PRINCIPLES.md, PRACTICES.md
TanStack Query(React Query) v5๋ฅผ ์ฌ์ฉํ ๋ฐ์ดํฐ ํ์นญ ๊ตฌํ ์ ๋ฒ ์คํธ ํ๋ํฐ์ค๋ฅผ ์ ์ฉํฉ๋๋ค. useQuery, useSuspenseQuery, useMutation ํ ์ ํ, ์๋ฌ ํธ๋ค๋ง, Query Key Factory ํจํด, Cache Invalidation ์ ๋ต, SSR Prefetch ํจํด ๋ฑ TanStack Query์ ํต์ฌ ํจํด์ ์ฌ๋ฐ๋ฅด๊ฒ ๊ตฌํํ๋๋ก ์๋ดํฉ๋๋ค.
npm install @tanstack/react-query @tanstack/react-query-devtools react-error-boundary
| v4 (deprecated) | v5 (current) |
|---|---|
cacheTime | gcTime |
useQuery์ onSuccess, onError, onSettled ์ฝ๋ฐฑ | ์ ๊ฑฐ๋จ โ ์ปดํฌ๋ํธ/ํ ๋ ๋ฒจ์์ ์ฒ๋ฆฌ |
useMutation์ onSuccess | deprecated โ onSettled ์ฌ์ฉ |
useFormState | useActionState (React 19) |
getNextPageParam ๋ฐํ undefined | null ๋ฐํ์ผ๋ก ๋ง์ง๋ง ํ์ด์ง ํ์ |
| ์ํฉ | ํ |
|---|---|
| ๊ธฐ๋ณธ ๋ฐ์ดํฐ ์กฐํ | useQuery |
| ์กฐ๊ฑด๋ถ ๋ฐ์ดํฐ ์กฐํ | useQuery + enabled |
| ์ ์ธํ ๋ฐ์ดํฐ ์กฐํ (Suspense) | useSuspenseQuery |
| ๋์ ๋ณ๋ ฌ ์กฐํ | useQueries / useSuspenseQueries |
| ๋ฌดํ ์คํฌ๋กค / ํ์ด์ง๋ค์ด์ | useInfiniteQuery / useSuspenseInfiniteQuery |
| ์์ฑ / ์์ / ์ญ์ | useMutation |
| SSR ํ๋ฆฌํ์น (์๋ฒ) | queryClient.prefetchQuery |
| SSR ํ๋ฆฌํ์น (์ปดํฌ๋ํธ) | usePrefetchQuery |
@queries/
โโโ [domain]/
โ โโโ keys.ts # Query Key Factory
โ โโโ use[Domain]List.ts
โ โโโ use[Domain]Detail.ts
โ โโโ use[Domain]Create.ts
โ โโโ use[Domain]Update.ts
โ โโโ use[Domain]Delete.ts
โโโ student/
โ โโโ keys.ts
โ โโโ useStudentList.ts
โ โโโ useStudentDetail.ts
โโโ bookmark/
โโโ keys.ts
โโโ useBookmarkList.ts
keys.ts๋ก Query Key Factory ๋ฐฐ์นUnderstanding defaults? โ references/guides-and-concepts/01-important-defaults.md
staleTime, gcTime, retry ๊ธฐ๋ณธ๊ฐWriting queries? โ references/guides-and-concepts/02-queries.md
Defining query keys? โ references/guides-and-concepts/03-query-keys.md
Writing query functions? โ references/guides-and-concepts/04-query-functions.md
queryFn ์์ฑ, AbortSignal, ์๋ฌ ์ฒ๋ฆฌUsing query options? โ references/guides-and-concepts/05-query-options.md
queryOptions ํฌํผ๋ก ํ์
์์ ํ ์ต์
์ฌ์ฌ์ฉNetwork mode? โ references/guides-and-concepts/06-network-mode.md
online, always, offlineFirst ๋ชจ๋Parallel queries? โ references/guides-and-concepts/07-parallel-queries.md
useQueries๋ก ๋์ ๋ณ๋ ฌ ์คํDependent queries? โ references/guides-and-concepts/08-dependent-queries.md
enabled ์ต์
์ผ๋ก ์์ฐจ ์คํBackground fetching indicators? โ references/guides-and-concepts/09-background-fetching-indicators.md
isFetching, isRefetching ์ํ ํ์Window focus refetching? โ references/guides-and-concepts/10-window-focus-refetching.md
refetchOnWindowFocus ์ค์ Disabling queries? โ references/guides-and-concepts/11-disabling-queries.md
enabled: false, lazy query ํจํดQuery retries? โ references/guides-and-concepts/12-query-retries.md
retry, retryDelay ์ปค์คํ
์ ๋ตPaginated queries? โ references/guides-and-concepts/13-paginated-queries.md
placeholderData: keepPreviousData ํจํดInfinite queries? โ references/guides-and-concepts/14-infinite-queries.md
useInfiniteQuery, getNextPageParamInitial query data? โ references/guides-and-concepts/15-initial-query-data.md
initialData๋ก ์ด๊ธฐ ๋ฐ์ดํฐ ์ค์ Placeholder data? โ references/guides-and-concepts/16-placeholder-query-data.md
placeholderData๋ก ์์ ๋ฐ์ดํฐ ํ์Writing mutations? โ references/guides-and-concepts/17-mutations.md
useMutation, onSettled, ์ํ ๊ด๋ฆฌQuery invalidation? โ references/guides-and-concepts/18-query-invalidation.md
invalidateQueries ์ ๋ตInvalidation from mutations? โ references/guides-and-concepts/19-invalidations-from-mutations.md
Updating from mutation responses? โ references/guides-and-concepts/20-updates-from-mutation-responses.md
setQueryData๋ก ์บ์ ์ง์ ์
๋ฐ์ดํธOptimistic updates? โ references/guides-and-concepts/21-optimistic-updates.md
Query cancellation? โ references/guides-and-concepts/22-query-cancellation.md
AbortController, ์ฟผ๋ฆฌ ์ทจ์Scroll restoration? โ references/guides-and-concepts/23-scroll-restoration.md
Filters? โ references/guides-and-concepts/24-filters.md
QueryFilters, MutationFiltersPerformance & waterfalls? โ references/guides-and-concepts/25-performance-request-waterfalls.md
Prefetching & router integration? โ references/guides-and-concepts/26-prefetching-router-integration.md
Server rendering & hydration? โ references/guides-and-concepts/27-server-rendering-hydration.md
HydrationBoundary, dehydrateAdvanced server rendering? โ references/guides-and-concepts/28-advanced-server-rendering.md
Caching examples? โ references/guides-and-concepts/29-caching-examples.md
Render optimizations? โ references/guides-and-concepts/30-render-optimizations.md
notifyOnChangeProps, ๊ตฌ์กฐ์ ๊ณต์ Default query function? โ references/guides-and-concepts/31-default-query-function.md
queryFn ์ค์ Suspense? โ references/guides-and-concepts/32-suspense.md
useSuspenseQuery, Suspense ๊ฒฝ๊ณTesting? โ references/guides-and-concepts/33-testing.md
renderHookReplacing other libraries? โ references/guides-and-concepts/34-possibility-replace.md
QueryClient methods? โ references/api-reference/01-query-client.md
fetchQuery, prefetchQuery, invalidateQueries ๋ฑ 31๊ฐ ๋ฉ์๋QueryCache? โ references/api-reference/02-query-cache.md
onError, onSuccessMutationCache? โ references/api-reference/03-mutation-cache.md
QueryObserver? โ references/api-reference/04-query-observer.md
InfiniteQueryObserver? โ references/api-reference/05-infinite-query-observer.md
QueriesObserver? โ references/api-reference/06-queries-observer.md
StreamedQuery? โ references/api-reference/07-streamed-query.md
FocusManager? โ references/api-reference/08-focus-manager.md
OnlineManager? โ references/api-reference/09-online-manager.md
NotifyManager? โ references/api-reference/10-notify-manager.md
TimeoutManager? โ references/api-reference/11-timeout-manager.md
useQuery? โ references/api-reference/12-use-query.md
useQueries? โ references/api-reference/13-use-queries.md
useInfiniteQuery? โ references/api-reference/14-use-infinite-query.md
useMutation? โ references/api-reference/15-use-mutation.md
onSettled, onErroruseIsFetching? โ references/api-reference/16-use-is-fetching.md
useIsMutating? โ references/api-reference/17-use-is-mutating.md
useMutationState? โ references/api-reference/18-use-mutation-state.md
useSuspenseQuery? โ references/api-reference/19-use-suspense-query.md
useSuspenseInfiniteQuery? โ references/api-reference/20-use-suspense-infinite-query.md
useSuspenseQueries? โ references/api-reference/21-use-suspense-queries.md
QueryClientProvider? โ references/api-reference/22-query-client-provider.md
useQueryClient? โ references/api-reference/23-use-query-client.md
queryClient ์ ๊ทผqueryOptions? โ references/api-reference/24-query-options.md
infiniteQueryOptions? โ references/api-reference/25-infinite-query-options.md
mutationOptions? โ references/api-reference/26-mutation-options.md
usePrefetchQuery? โ references/api-reference/27-use-prefetch-query.md
usePrefetchInfiniteQuery? โ references/api-reference/28-use-prefetch-infinite-query.md
QueryErrorResetBoundary? โ references/api-reference/29-query-error-reset-boundary.md
useQueryErrorResetBoundary? โ references/api-reference/30-use-query-error-reset-boundary.md
Hydration? โ references/api-reference/31-hydration.md
dehydrate, HydrationBoundary, SSR ํตํฉ