![\"Stoic](\"./docs/assets/image.png\")
\nStoic
\n\n\n \n
\nTiny React state manager with reactive derived state.\n
\n\n\nNo reducers • No dependency arrays • No boilerplate • Fully typed • Plugin-based\n
\n\n\n![\"npm](\"https://img.shields.io/npm/v/stoic-store.svg\")
\n![\"CI](\"https://github.com/peakercope/stoic/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n![\"2.4](\"https://img.shields.io/badge/core-2.4%20kB%20gzip-blue\"){kind=icon}
![\"TypeScript](\"https://img.shields.io/badge/types-included-blue\"){kind=icon}
![\"MIT](\"https://img.shields.io/npm/l/stoic-store.svg\")
\n
\nQuick Start •\nCore Concepts •\nDerived State •\nAPI Reference •\nDocumentation\n
\n\n---\n\nStoic is a small state management library for React, built on `useSyncExternalStore`. You define state and actions much like you would with any store library, but Stoic also lets you declare **derived state** — values computed from other state — as part of the store itself.\n\nThe key difference from most state managers: Stoic tracks the relationships between your state automatically. When something changes, only the derived values that actually depend on it are recomputed, and only the components reading those values rerender. There are no dependency arrays to maintain.\n\n* ⚡️ Plain function actions — no dispatch, no action types\n* 🧠 Reactive derived state with automatic dependency tracking\n* 🚀 First-class async actions, with built-in pending/error status and `AbortSignal` cancellation\n* 🔌 A small plugin system (`persist` and `devtools` are included; write your own for the rest)\n* 💙 Fully typed, with state and action arguments inferred by your editor\n\n## Installation\n\n```bash\nnpm install stoic-store\n```\n\nRequires React 18+. Published as ESM only. See [Installation](./docs/installation.md).\n\n## Usage\n\n```ts\nimport { createStore } from \"stoic-store\";\n\ntype State = { items: CartItem[]; tax: number };\ntype Derived = { subtotal: number; total: number };\n\nexport const cart = createStore