# pmndrs/zustand · RepoSense Release & Migration Intelligence

> The `persist` middleware now supports `PromiseLike` result. Drop-in upgrade. Migration: None.

## Metadata
- **Repository URL**: https://github.com/pmndrs/zustand
- **Primary Package**: `zustand` (NPM)
- **Categories**: `STATE_MANAGEMENT`
- **Latest Version**: `v5.1.0`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (min+gzip)**: `+2 B (+0.4%)`
- **Atom Ingestion Feed**: https://github.com/pmndrs/zustand/releases.atom

## The Human Context (Plain-English Pitch)
Zustand is a small, fast state management library for React applications. It solves the problem of passing props through dozens of component layers—or writing verbose Redux boilerplate—by letting any component read and update shared application state through a simple hook.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
The `persist` middleware now supports `PromiseLike` result. Drop-in upgrade. Migration: None.

## Breaking Changes & Required Actions
- The `persist` middleware now supports `PromiseLike` results from storage reads, migrations, and migration writes. `persist.rehydrate()` now returns a native `Promise<void>...
- The `devtools` middleware now supports dispatching store actions directly from Redux DevTools using the new `actionCreators` option. It also supports nested actions and arguments.
- fix(middleware): persist migration supporting promise-like by @dai-shi in #3583
- fix(middleware): devtools action dispatching by @dai-shi in #3595

## Migration Snippet
```ts
npm install zustand@5.1.0
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript 5.x** [`COMPATIBLE`]: Ships standard TypeScript declaration files without type regressions.

## Zero-Noise Release Timeline
- **v5.1.0** (2026-11-06) [COMPATIBLE]: The `persist` middleware now supports `PromiseLike` result. Drop-in upgrade. Migration: None.
- **v5.0.16** (2026-10-22) [COMPATIBLE]: perf(react): don't memoize getServerSnapshot in useStore b. Drop-in upgrade. Migration: None.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is pmndrs/zustand v5.1.0 safe to upgrade in production?
pmndrs/zustand v5.1.0 is classified as COMPATIBLE (MINOR release). The `persist` middleware now supports `PromiseLike` result. Drop-in upgrade. Migration: None.

### What breaking changes or compatibility risks exist in pmndrs/zustand v5.1.0?
No breaking API changes or peer dependency conflicts are recorded for pmndrs/zustand v5.1.0 in the RepoSense compatibility graph.

### What is the bundle size impact of zustand v5.1.0?
zustand v5.1.0 records a +2 B (+0.4%) delta (min+gzip), moving from 489 bytes to 491 bytes.

### How do I upgrade zustand to v5.1.0?
Upgrade zustand to v5.1.0 by running "npm install zustand@5.1.0" and applying the migration steps: npm install zustand@5.1.0