---

name: state-management description: Manage client and server state with Zustand stores and React Query patterns.

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

Decision Tree

CopyIs 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.