zustand-state-management

SKILL.md

Last Updated: 2026-01-21 Latest Version: zustand@5.0.10 (released 2026-01-12) Dependencies: React 18-19, TypeScript 5+

✅ Use create ()() (double parentheses) in TypeScript for middleware compatibility ✅ Define separate interfaces for state and actions ✅ Use selector functions to extract specific state slices ✅ Use set with updater functions for derived state: set((state) => ({ count: state.count + 1 })) ✅ Use unique names for persist middleware storage keys

✅ Handle Next.js hydration with hasHydrated flag pattern ✅ Use useShallow hook for selecting multiple values ✅ Keep actions pure (no side effects except state updates)

使用 Zustand 在 React 中構建類型安全的全局狀態。支持 TypeScript、持久中間件、開發工具、切片模式和帶有水合處理的 Next.js SSR。防止 6 個已記錄的錯誤。 在設置 React 狀態、從 Redux/Context 遷移或排除水合錯誤、TypeScript 推理、無限渲染循環或持久競爭條件時使用。 來源：sovranbitcoin/sovran。

查看原文