state-management

# State Management Choose the right state solution for each use case. ## Activation Conditions - Managing global state - Persisting state across navigation - Cross-component data sharing - Questions about Zustand vs React Query ## Quick Reference | Action | Rule | |--------|------| | Read from store | `use-zustand-selectors.md` | | Persist state | `use-zustand-persist.md` | | Fetch server data | `use-react-query-for-server.md` | ## Decision Tree ``` Is it server data (API response)? ├── Yes → React Query / Connect Query │ (caching, refetching, invalidation) └── No → Is it URL state? ├── Yes → React Router │ (search params, path params) └── No → Is it form state? ├── Yes → React Hook Form │ (validation, submission) └── No → Is it shared across components? ├── Yes → Zustand │ (global, persisted) └── No → useState / useReducer (local component state) ``` ## Rules See `rules/` directory for detailed guidance.