Store API Reference

useCreateAtom

Function: useCreateAtom()

Call Signature

ts
function useCreateAtom<T>(getValue, options?): ReadonlyAtom<T>;
function useCreateAtom<T>(getValue, options?): ReadonlyAtom<T>;

Defined in: packages/react-store/src/useCreateAtom.ts:17

Creates a stable atom instance for the lifetime of the component.

Pass an initial value to create a writable atom, or a getter function to create a readonly derived atom. This hook mirrors the overloads from createAtom, but ensures the atom is only created once per mount.

Type Parameters

T

T

Parameters

getValue

(prev?) => T

options?

AtomOptions<T>

Returns

ReadonlyAtom<T>

Example

tsx
const countAtom = useCreateAtom(0)
const countAtom = useCreateAtom(0)

Call Signature

ts
function useCreateAtom<T>(initialValue, options?): Atom<T>;
function useCreateAtom<T>(initialValue, options?): Atom<T>;

Defined in: packages/react-store/src/useCreateAtom.ts:21

Creates a stable atom instance for the lifetime of the component.

Pass an initial value to create a writable atom, or a getter function to create a readonly derived atom. This hook mirrors the overloads from createAtom, but ensures the atom is only created once per mount.

Type Parameters

T

T

Parameters

initialValue

T

options?

AtomOptions<T>

Returns

Atom<T>

Example

tsx
const countAtom = useCreateAtom(0)
const countAtom = useCreateAtom(0)