Reference TanStack Query support in the stack positioning

[justin808]

Reference TanStack Query support in the stack positioning

ShakaStack's thesis is "embrace TanStack Query / Router / Table, substitute for TanStack Start." There's now a concrete, citeable proof for the Query half: the Using TanStack Query guide (shakacode/react_on_rails#4237) and the live starter. The site should link them.

What to add

A short section / FAQ entry (candidates: src/components/Stack.astro or StackExplorer.tsx, src/components/Faq.astro, src/components/VsNextjs.astro, content in src/data/shaka.ts) that:

• States TanStack Query is the recommended client-side server-state layer on a Rails JSON API, and
• Links the guide + the starter as proof.

Suggested copy

Does ShakaStack work with TanStack? Yes — Query, Router, and Table are first-class. Rails stays the source of truth; TanStack Query gives React caching, refetching, mutations, and first-paint data. See the Using TanStack Query guide and the runnable starter. (We embrace TanStack's client libraries; we substitute Rails + React on Rails Pro for TanStack Start, the server tier.)

For the Start-vs-RoR framing, see shakacode/react_on_rails#4242 and shakacode/react_on_rails#4246.

The TanStack Query support to link

• 📘 Guide: Using TanStack Query — https://reactonrails.com/docs/building-features/tanstack-query
• 🧭 Companion: Using TanStack Router — https://reactonrails.com/docs/building-features/tanstack-router
• 🚀 Reference app (the official starter): https://github.com/shakacode/react-on-rails-starter-tanstack — live at https://starter.reactonrails.com
• 🔀 Migration note: https://reactonrails.com/docs/migrating/rsc-data-fetching#migrating-from-react-query--tanstack-query

Context: the guide is new (shakacode/react_on_rails#4237, merged) and presents TanStack Query as the recommended client-side server-state layer for Rails-backed React apps. This issue is one of a small cross-repo set adding references to it.

[justin808]

Scoping note for the update task (investigated the current site):

• main already carries the TanStack positioning in src/data/shaka.ts — the embrace/substitute split, the "TanStack Starter" project card, the "TanStack Query owns the client" copy, and links to the starter + the TanStack Router guide.
• The one real gap: the new Using TanStack Query guide (https://reactonrails.com/docs/building-features/tanstack-query, merged in docs: add TanStack Query guide for React on Rails react_on_rails#4237) isn't linked yet. shaka.ts has TANSTACK_ROUTER_DOC but no query-guide equivalent.
• Suggested minimal change: add export const TANSTACK_QUERY_DOC = "https://reactonrails.com/docs/building-features/tanstack-query"; next to TANSTACK_ROUTER_DOC, and surface it wherever the router doc link renders.

I did not open a PR for this: there's in-progress positioning work touching shaka.ts, so this link is best folded into that branch to avoid a conflicting edit.