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.