[nightt5879]

Summary

Closes #35283.

Adds clarification to the TanStack React framework docs explaining why the recommended TanStack Query setup uses one shared QueryClient that is cleared between stories.

The new note also documents when a per-story QueryClient can be useful, especially for multiple stories rendered on the same Docs page with the same query keys, and calls out the tradeoffs around keeping the router context and QueryClientProvider wired to the same client.

What changed

• Clarified that the shared client keeps router context, decorators, loaders, portable stories, Docs, and test runs using one predictable integration point.
• Documented the stronger isolation provided by per-story clients.
• Documented the risks of mismatched router/provider clients and the need to clean up per-story client-owned state.

Testing

• corepack yarn install --immutable --mode=skip-build
• corepack yarn fmt:write
• corepack yarn docs:check

Manual testing

Docs-only change. Manually reviewed the rendered Markdown source around the TanStack Query section to confirm the new guidance appears after the setup snippet and before the per-story seeding example.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b8550614-818a-4a7f-8e34-c8cb9bcdeb02

📥 Commits

Reviewing files that changed from the base of the PR and between bf34cdb and 8bc4ba7.

📒 Files selected for processing (1)

• docs/get-started/frameworks/tanstack-react.mdx

---

📝 Walkthrough

Walkthrough

Adds four lines to the TanStack React framework docs explaining that the shared QueryClient is used across all Storybook render modes, and describing the per-story QueryClient isolation alternative, including wiring and cleanup requirements.

Changes

TanStack QueryClient Documentation

Layer / File(s)	Summary
QueryClient setup guidance docs/get-started/frameworks/tanstack-react.mdx	Adds text clarifying shared QueryClient usage across Storybook render modes and the per-story isolation alternative, including the requirement to pass the same client to both parameters.tanstack.router.context and QueryClientProvider, plus explicit cleanup.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[nightt5879]

I don't have permission to add the required workflow labels on this repository. Suggested labels for this docs-only PR: \documentation, \ci:docs, \qa:skip.

[huang-julien]

Thank you !