Skip to content

raf-effect-atom and effect-atom-boundary are on npm. Both are pre-1.0, so a minor release can still break them. Install them

raf-effect-atom

Getting started

Installation

Install one package or both, with Effect, Effect Atom's React bindings and React as peers.

MarkdownAsk ChatGPT Ask Claude

Both packages need Effect and @effect/atom-react 4.0.6 or later, and React 19, as peer dependencies. Hydration relies on the registry's skipInitialRun, which Effect's registry reads from 4.0.6 on: with an older Effect, an atom the server sent runs again on its first read in the browser, which can render something other than the server's HTML: a hydration mismatch.

Typed error boundaries only

pnpm add effect-atom-boundary effect @effect/atom-react react

Loaders and streaming, with boundaries

pnpm add raf-effect-atom effect-atom-boundary effect @effect/atom-react react

The packages don't depend on each other: a boundary's hook takes the AsyncResult that raf-effect-atom's useAtomResult returns, as it takes any other read's. The framework integrations are subpath exports of raf-effect-atom, such as raf-effect-atom/tanstack-router, so there's nothing else to install.