Repo brief: TanStack/query

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T08:42:43.408Z · commit bfd42a5b79e2

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit today
• 8 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

TanStack Query is an async state management library that simplifies server-state handling across JavaScript frameworks (React, Vue, Solid, Svelte, Angular) with built-in caching, refetching, pagination, and mutations. It abstracts the complexity of synchronizing remote data with client state, supporting REST, GraphQL, and promise-based APIs without framework-specific overhead. Monorepo organized by framework: packages/angular-query-experimental/, packages/eslint-plugin-query/, and similar. Core pattern: each framework package exports a set of hooks/injectors (e.g., inject-query.ts, inject-mutation.ts) wrapping a shared query-core engine. Devtools and persistence layers are optional…

Start here

Read these in order:

• packages/vue-query/src/types.ts — Foundation: doesn't import anything internally and is imported by 16 other files. Read first to learn the vocabulary.
• packages/preact-query/src/types.ts — Foundation: imported by 14, no internal dependencies of its own.
• packages/vue-query/src/utils.ts — Built on the foundation; imported by 13 downstream files.
• packages/angular-query-experimental/src/types.ts — Built on the foundation; imported by 9 downstream files.
• packages/preact-query/src/useBaseQuery.ts — Layer 2 — composes lower-level code into reusable abstractions (imported 4×).

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/TanStack/query.git
cd query
npm install
npm run start  # or framework-specific setup per packages/*/package.json

Refer to the specific framework package (e.g., packages/angular-query-experimental/) for its own package.json scripts.

Daily commands:

npm install
npm run start

For Angular example: npm run ng -- serve. Actual dev commands vary by workspace; check each package's scripts. Build: npm run build; watch: npm run watch.

Key cautions & unknowns

• Single-maintainer risk — top contributor 91% of recent commits
• Scorecard: default branch unprotected (0/10)
• Angular 20 requirement: This example uses Angular 20 (^20.0.0), which is very recent; older codebases must upgrade significantly. Experimental API: angular-query-experimental package name signals breaking…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.