Another react state library but it's the one I wanted to use

2 hours ago 2

npm bundle size

The state management library I wanted to use. No signals, no wrappers. Just getting and setting the state.

import { createState } from "react-create-state"; const [useCounter, setCount] = createState(0); const useDoubleCounter = () => { return useCounter((n) => n * 2); }; const Counter = () => { const counter: number = useCounter(); const dbl: number = useDoubleCounter(); return ( <div onClick={() => setCount((n) => n + 1)}> My count: {counter} Doubled: {dlb} </div> ); };
react-create-state Zustand Jotai react-use createGlobalState
Size 527B 603B 4.3KB 22KB*
React hook
Memoisation
Globally accessible
Update outside component
Peeking
Subscriptions
async/promises
SSR
Learning Curve Gentle Mild Steep Very Gentle
Ergonomics** Pleasant Bit Awkward Functional Simple

* Requires installing whole of the react-use package
** How easy it is to use and write code with. This is quite subjective depending on your experience and preference

createState(state) => [useState, setState, getState, subscribe]

The createState function initialises some new global state. Call this function outside of React components (or render functions).

The functions returned are documented below.

const [useState] = createState({ a: { b: { c: "foo" } } });

React hook that returns the current state. When the state changes, the component will rerender.

const state = useState(); // { a: { b: { c: 'foo' } } }

It can be called with a selector function. Only when the return value of the selector changes will the component be re-rendered. I.e. the selector is memoised.

const c = useState((state) => state.a.b.c); // 'foo'

You can also depend on other values with a deps array:

let [greeting, setGreeting] = React.useState("Hello"); const msg = useState((state) => `${greeting} ${state.a.b.c}`, [greeting]); msg; // 'Hello foo' // Later... setGreeting("Howdy"); // `msg` will update because `greeting` is in it's deps array msg; // 'Howdy foo'

State is updated by calling this function either with a new value or a function that takes the previous state and returns the new state.

const [useState, setState] = createState({ a: { b: { c: "foo" } } }); setState({ something: "foo" }); // or setState((state) => ({ something: state.a.b.c }));

State must not be mutated. Always return new references if a value has changed.

setState((state) => ({ ...state, a: { ...state.a, b: { ...state.a.b, c: "bar", }, }, }));

This kind of immutable updates can be tiring to write so you can make use of libraries like lodash-redux-immutability.

setState((state) => updateIn(state, ["a", "b", "c"], "bar"));

You could also use Immer but there are some pitfalls.

Returns the current value of the state. This function can be used wherever, inside or outside a component.

const [useState, setState, getState] = createState({ a: { b: { c: "foo" } } }); const { a: { b }, } = getState(); console.log(b.c); // 'foo'

This can be handy for accessing the value of the state inside a useEffect without depending on the value. E.g.

const MyComponent = ({ myProp }: { myProp: string }) => { useEffect(() => { // triggered when `myProp` changes but not when the state does doSomething(getState()); }, [myProp]); //... };

You subscribe to state changes without the useState hook. Subscribers are synchronously called with the current value of the state. And called for all subsequent updates. There is no guarantee which order subscribers are called in.

It returns an unsubscribe function that synchronously removes the subscription.

const [useState, setState, getState, subscribe] = createState("foo"); const unsub = subscribe((state) => { console.log(state); }); // 'foo' logged setState("bar"); // 'bar' logged unsub(); setState("baz"); // 'baz' not logged

Subscriptions are useful for a number of cases:

  • if you are working outside a React application
  • you want to persist the state to localStorage or elsewhere
  • for logging or analytic purposes

This function sets all instances of createState back to the initial value. This is useful for unit tests to isolate each case or during SSR so each request gets the starting state.

import { createState, reinitializeAll } from "react-create-state"; const [, setNum, getNum] = createState(0); const [, setStr, getStr] = createState("foo"); const [, setBool, getBool] = createState(true); setNum(1); setStr("bar"); setBool(false); reinitializeAll(); getNum(); // 0 getStr(); // 'foo' getBool(); // true

All subscriptions (including useState hooks) are called with the initial values.

Read Entire Article