<!--
Sitemap:
- [rxfy](/index): Typed, normalized, reactive state — built on RxJS
- [Comparison](/comparison): rxfy versus Redux Toolkit, MobX, Jotai, and TanStack Query
- [Agent Skills](/agent-skills): Accurate rxfy context for AI coding assistants
- [Examples](/examples): Runnable apps, from client-only to fully live
- [Changelog](/changelog)
- [Getting Started](/getting-started)
- [Store quickstart](/getting-started/store): Normalized reactive state in a client-only app
- [Framework quickstart](/getting-started/framework): The full stack for a live app
- [Core Concepts](/core-concepts): The ideas rxfy is built on
- [Normalization](/core-concepts/normalization): Store each entity once, reference it by id
- [Late Unwrapping](/core-concepts/late-unwrapping): Unwrap async state at the leaf, not the trunk
- [Server-Side Rendering](/core-concepts/ssr): Dehydrate on the server, hydrate with no refetch
- [rxfy](/rxfy): The core package: atoms, lenses, models, and states
- [createModel](/rxfy/create-model): Typed entities in normalized storage
- [defineState](/rxfy/define-state): Typed, normalized state shapes with fetching and mutations
- [createAtom](/rxfy/create-atom): A reactive cell with synchronous get, set, and modify
- [createLens](/rxfy/create-lens): A two-way view into part of an Atom
- [React Bindings](/react): Hooks and helpers for using rxfy in React
- [useStateData](/react/use-state-data): Fetch, normalize, and subscribe to a query
- [useStatePagedData](/react/use-state-paged-data): Paginated and infinite-scroll lists
- [useModelStore](/react/use-model-store): Subscribe to one normalized entity by id
- [useAtom](/react/use-atom): Two-way binding for any IAtom
- [Pending](/react/pending): Render pending, rejected, and fulfilled UI for any observable
- [usePending](/react/use-pending): The status value behind Pending
- [useObservable](/react/use-observable): Bind a raw Observable to React
- [Live client](/react/live-client): Wire a WebSocket transport into StoreProvider
- [rxfy-server](/framework/server): Bind Drizzle tables, write, and publish live updates
- [defineResource](/framework/server/define-resource): Tie a Drizzle table to an rxfy model
- [createServer](/framework/server/create-server): Wire db, resources, hub, and keyer into a Live object
- [Writes](/framework/server/writes): live.create / live.update / live.delete and touch
- [Live messages](/framework/server/messages): What travels between server and client
- [Grants & live hydration](/framework/server/grants): Hand off an SSR render to a live client
- [createTopicKeyer](/framework/server/create-topic-keyer): Time-windowed HMAC ids for topics
- [createInMemoryHub](/framework/server/hub): The pub/sub backbone
- [rxfy-ws](/framework/ws): The default WebSocket transport
- [createWsServer](/framework/ws/server): Attach a Hub to WebSocket connections
- [createWsClient](/framework/ws/client): The browser transport with reconnect and replay
- [Custom transports](/framework/ws/custom-transport): Bring your own ClientTransport
- [Guides](/guides): Task-focused walkthroughs of common rxfy patterns
- [Build a Todo app](/guides/todo-app): A guided, end-to-end first app
- [Pagination and infinite scroll](/guides/pagination): Load and append pages into one normalized list
- [Live blog](/guides/live-blog): Build a real-time blog: SSR, then live patches and stale badges
-->

# React Bindings \[Hooks and helpers for using rxfy in React]

`rxfy-react` is the official React binding for rxfy. Wrap your tree in `StoreProvider`
(see [Getting Started](/getting-started)), then reach for the hook you need:

* [`useStateData`](/react/use-state-data) — fetch, normalize, and subscribe to a query;
  returns a `StateHandle` (`data$`, `set`, `setRaw`, `reload`, `mutations`). Covers
  `defaultData` seeding and `set` vs `setRaw`.
* [`useStatePagedData`](/react/use-state-paged-data) — paginated / infinite-scroll lists of
  a single entity type, built on `useStateData`.
* [`useModelStore`](/react/use-model-store) — subscribe to one normalized entity by id.
* [`useAtom`](/react/use-atom) — two-way binding for any `IAtom` (a plain `Atom`, a `Lens`,
  or a `ModelStore.entity(id)` cell).
* [`Pending`](/react/pending) — render pending / rejected / fulfilled UI for any observable.
* [`usePending`](/react/use-pending) — the status value behind `Pending`, when you need the
  `IWrapped<T>` rather than rendered UI.
* [`useObservable`](/react/use-observable) — bind a raw `Observable<T>` to React.
* [`createLiveClient` / live client](/react/live-client) — connect a WebSocket transport so
  server pushes land in the store; exposes `updatesAvailable$` for refresh affordances. Used
  by the [live-update framework](/framework/server).

`data$` from `useStateData` (and `useStatePagedData`) emits the **normalized query shape:
entity ids, not entities**. Render lists by id and read entity data through
[`useModelStore`](/react/use-model-store).