A Molecular State Engine for React.
Note
Zedux v2 is right around the corner! This readme has been updated for v2, and the docs are steadily getting there. Despite documentation being sparse, it's highly recommended that new projects use the latest stable v2 release candidate. Refer to the v2 migration guide for a v2 quick start.
Zedux is a multi-paradigm state management tool that features a powerful signals implementation wrapped in a DI-driven atomic architecture.
npm install @zedux/react # npm
yarn add @zedux/react # yarn
pnpm add @zedux/react # pnpmThe React package (@zedux/react) contains everything you need to use Zedux in a React app - the core atomic model and all React-specific APIs.
@zedux/react has a peer dependency on React. It has partial support for React 18, but primarily supports React 19 and up.
We borrowed ideas from dozens of state management tools over the past 5 years, invented a few ourselves, and put it all together in one powerhouse of a state management library.
Think of Zedux as a cross between React Query, Valtio, and Recoil/Jotai + Bunshi. It's both a cache manager and a normal state manager with real Dependency Injection, rich events, opt-in mutation proxying, and an extension model patterned after React itself.
Sound complex? Zedux is actually very beginner-friendly. In fact, here's all you need to begin:
import { atom, useAtomState } from '@zedux/react'
const greetingAtom = atom('greeting', 'Hello, World!')
function Greeting() {
const [greeting, setGreeting] = useAtomState(greetingAtom)
return (
<input
onChange={event => setGreeting(event.target.value)}
value={greeting}
/>
)
}We'll break down this example and so much more in the docs.
To embark on the journey of mastering Zedux, jump into the quick start.
If you prefer something more high-level, the introduction's a decent place to start. Or if you want to learn Everything Everywhere All at Once, the API docs or repo source code and tests are real page-turners.
Happy coding!
Contributions an any level are absolutely welcome! Have a look at the contribution guidelines.
Bugs can be reported here.
Questions, feature requests, ideas, and links to cool projects or examples are always welcome in the discussions page.
The MIT License.