Skip to content
TanStackIntent
TanStack Intent/Registry/@stainless-code/persist

@stainless-code/persist

Hydration-aware persistence for any reactive store — zero-dep persistSource core; codecs, backends, cross-tab transport, source + framework hydration adapters ship as opt-in recipes

persist-async-storage

49 linesSource

Persist with React Native AsyncStorage via @stainless-code/persist/backends/async-storage. Use for RN string-wire JSON state; always gate with useHydrated.

AsyncStorage backend

JSON via createJSONStorage under the hood. Fully async → useHydrated mandatory. Factory does not accept clearCorruptOnFailure — use createStorage(() => asyncStorageStateStorage(), jsonCodec(), opts) when you need it.

Install

shell
bun add @stainless-code/persist @react-native-async-storage/async-storage

Peer: @react-native-async-storage/async-storage >=1.0.0.

Minimal wiring

ts
import { createAsyncStorage } from "@stainless-code/persist/backends/async-storage";

const storage = createAsyncStorage<Prefs>()!;

Optional custom instance for namespacing: createAsyncStorage(myAsyncStorage).

Common mistakes

  • Treating hydrate as sync.
  • Expecting Set/Map/Date — use seroval compose or avoid.
  • Passing clearCorruptOnFailure to the factory.

API surface

  • createAsyncStorage(storage?) · asyncStorageStateStorage(storage?)

See also: persist-mmkv (sync RN).