К основному содержанию
скилл CX Codex

zustand-state-management · secondsky — скилл для Claude Code

Скилл zustand-state-management помогает настраивать глобальный стейт на Zustand в проектах на React 18+ и TypeScript 5+. Предотвращает ошибки гидратации в Next.js и зацикливание рендеров.

MIT 301 установок ★ 250 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add secondsky/claude-skills --skill zustand-state-management -a claude-code
Открыть на GitHub

Что делает zustand-state-management

Скилл учит ассистента создавать хранилища Zustand v5 по надёжным паттернам для TypeScript. Главная деталь реализации — каррированный синтаксис create<T>()(), без которого ломается вывод типов при подключении мидлваров.

Внутри заложены шаблоны для базовых сторов, сохранения данных в localStorage через persist и связки с Redux DevTools. Для Next.js даётся схема защиты от hydration mismatch с флагом _hasHydrated. При прямом обращении к браузерному хранилищу без такой проверки SSR упадёт с ошибкой.

Какие задачи решает

  • настроить типизированный стор с каррированием create<T>()()
  • подключить сохранение стейта в localStorage через persist
  • устранить ошибки гидратации в Next.js с помощью флага _hasHydrated
  • настроить интеграцию с Redux DevTools и immer

Примеры запросов агенту

  • Создай типизированный стор Zustand для корзины покупок с сохранением в localStorage
  • Добавь в стор Zustand мидлвар devtools и настрой селекторы с shallow
  • Исправь ошибку Text content does not match в компоненте со стором Zustand

Как установить zustand-state-management

1Через Skills CLI (Vercel)

npx skills add secondsky/claude-skills --skill zustand-state-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/zustand-state-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/zustand-state-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о zustand-state-management

Как установить zustand-state-management в Claude Code?

Выполните команду: npx skills add secondsky/claude-skills --skill zustand-state-management -a claude-code.

Для чего нужен этот скилл?

Он даёт проверенные паттерны работы с Zustand 5 в связке с React 18+ и TypeScript 5+. Помогает избежать сбоев типов при добавлении мидлваров и предотвращает бесконечные рендеры.

Зачем в коде стора двойные скобки create<T>()()?

Это требование TypeScript для корректного вывода типов при использовании мидлваров persist или devtools. Одинарные скобки ломают типизацию состояния.

Исходный текст

SKILL.md · MIT
---
name: zustand-state-management
description: "Zustand state management for React with TypeScript. Use for global state, Redux/Context API migration, localStorage persistence, slices pattern, devtools, Next.js SSR, or encountering hydration errors, TypeScript inference issues, persist middleware problems, infinite render loops."

metadata:
  keywords:
    - zustand
    - state management
    - React state
    - TypeScript state
    - persist middleware
    - devtools
    - slices pattern
    - global state
    - React hooks
    - create store
    - useBoundStore
    - StateCreator
    - hydration error
    - text content mismatch
    - infinite render
    - localStorage
    - sessionStorage
    - immer middleware
    - shallow equality
    - selector pattern
    - zustand v5

license: MIT
---
# Zustand State Management

**Status**: Production Ready ✅
**Last Updated**: 2026-08-03
**Latest Version**: [email protected]
**Dependencies**: React 18+, TypeScript 5+

---

## Quick Start (3 Minutes)

### 1. Install Zustand

```bash
bun add zustand  # preferred
# or: npm install zustand
# or: yarn add zustand
```

**Why Zustand?**
- Minimal API: Only 1 function to learn (`create`)
- No boilerplate: No providers, reducers, or actions
- TypeScript-first: Excellent type inference
- Fast: Fine-grained subscriptions prevent unnecessary re-renders
- Flexible: Middleware for persistence, devtools, and more

### 2. Create Your First Store (TypeScript)

```typescript
import { create } from 'zustand'

interface BearStore {
  bears: number
  increase: (by: number) => void
  reset: () => void
}

const useBearStore = create<BearStore>()((set) => ({
  bears: 0,
  increase: (by) => set((state) => ({ bears: state.bears + by })),
  reset: () => set({ bears: 0 }),
}))
```

**CRITICAL**: Notice the **double parentheses** `create<T>()()` - this is required for TypeScript with middleware.

### 3. Use Store in Components

```tsx
import { useBearStore } from './store'

function BearCounter() {
  const bears = useBearStore((state) => state.bears)
  return <h1>{bears} around here...</h1>
}

function Controls() {
  const increase = useBearStore((state) => state.increase)
  return <button onClick={() => increase(1)}>Add bear</button>
}
```

**Why this works:**
- Components only re-render when their selected state changes
- No Context providers needed
- Selector function extracts specific state slice

---

## The 3-Pattern Setup Process

### Pattern 1: Basic Store (JavaScript)

For simple use cases without TypeScript:

```javascript
import { create } from 'zustand'

const useStore = create((set) => ({
  count: 0,
  increment: () => set((state) => ({ count: state.count + 1 })),
  decrement: () => set((state) => ({ count: state.count - 1 })),
}))
```

**When to use:**
- Prototyping
- Small apps
- No TypeScript in project

### Pattern 2: TypeScript Store (Recommended)

For production apps with type safety:

```typescript
import { create } from 'zustand'

// Define store interface
interface CounterStore {
  count: number
  increment: () => void
  decrement: () => void
}

// Create typed store
const useCounterStore = create<CounterStore>()((set) => ({
  count: 0,
  increment: () => set((state) => ({ count: state.count + 1 })),
  decrement: () => set((state) => ({ count: state.count - 1 })),
}))
```

**Key Points:**
- Separate interface for state + actions
- Use `create<T>()()` syntax (currying for middleware)
- Full IDE autocomplete and type checking

### Pattern 3: Persistent Store

For state that survives page reloads:

```typescript
import { create } from 'zustand'
import { persist, createJSONStorage } from 'zustand/middleware'

interface UserPreferences {
  theme: 'light' | 'dark' | 'system'
  language: string
  setTheme: (theme: UserPreferences['theme']) => void
  setLanguage: (language: string) => void
}

const usePreferencesStore = create<UserPreferences>()(
  persist(
    (set) => ({
      theme: 'system',
      language: 'en',
      setTheme: (theme) => set({ theme }),
      setLanguage: (language) => set({ language }),
    }),
    {
      name: 'user-preferences', // unique name in localStorage
      storage: createJSONStorage(() => localStorage), // optional: defaults to localStorage
    },
  ),
)
```

**Why this matters:**
- State automatically saved to localStorage
- Restored on page reload
- Works with sessionStorage too
- Handles serialization automatically

---

## Critical Rules

### Always Do

✅ Use `create<T>()()` (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 `shallow` for selecting multiple values
✅ Keep actions pure (no side effects except state updates)

### Never Do

❌ Use `create<T>(...)` (single parentheses) in TypeScript - breaks middleware types
❌ Mutate state directly: `set((state) => { state.count++; return state })` - use immutable updates
❌ Create new objects in selectors: `useStore((state) => ({ a: state.a }))` - causes infinite renders
❌ Use same storage name for multiple stores - causes data collisions
❌ Access localStorage during SSR without hydration check
❌ Use Zustand for server state - use TanStack Query instead
❌ Export store instance directly - always export the hook

---

## Known Issues Prevention (5 Issues)

| Issue | Error | Quick Fix |
|-------|-------|-----------|
| **#1 Hydration mismatch** | "Text content does not match" | Use `_hasHydrated` flag + `onRehydrateStorage` |
| **#2 TypeScript inference** | Types break with middleware | Use `create<T>()()` double parentheses |
| **#3 Import error** | "createJSONStorage not exported" | Upgrade to [email protected]+ |
| **#4 Infinite loop** | Browser freezes | Use `shallow` or separate selectors |
| **#5 Slices types** | StateCreator types fail | Explicit `StateCreator<Combined, [], [], Slice>` |

**Most Critical** - TypeScript double parentheses:
```typescript
// ❌ WRONG: create<T>((set) => ...)
// ✅ CORRECT: create<T>()((set) => ...)
```

**See**: `references/known-issues.md` for complete solutions with code examples.

---

## Middleware Configuration

```typescript
import { create } from 'zustand'
import { devtools, persist } from 'zustand/middleware'

const useStore = create<MyStore>()(
  devtools(
    persist(
      (set) => ({ /* store definition */ }),
      { name: 'my-storage' },
    ),
    { name: 'MyStore' },
  ),
)
```

| Middleware | Purpose | Import |
|------------|---------|--------|
| `persist` | localStorage/sessionStorage | `zustand/middleware` |
| `devtools` | Redux DevTools integration | `zustand/middleware` |
| `immer` | Mutable update syntax | `zustand/middleware/immer` |

**Order matters**: `devtools(persist(...))` shows persist actions in DevTools.

**See**: `references/middleware-guide.md` for complete middleware documentation.

---

## Common Patterns

| Pattern | Use Case | Key Technique |
|---------|----------|---------------|
| **Computed values** | Derived data | Compute in selector: `state.items.length` |
| **Async actions** | API calls | `set({ isLoading: true })` + try/catch |
| **Reset store** | Logout, form clear | `set(initialState)` |
| **Selector with params** | Dynamic access | `state.todos.find(t => t.id === id)` |
| **Multiple stores** | Separation of concerns | Create separate `create()` calls |

**See**: `references/common-patterns.md` for complete implementations.

---

## Advanced Topics

| Topic | Use Case | Key API |
|-------|----------|---------|
| **Vanilla store** | Non-React, testing | `createStore()` from `zustand/vanilla` |
| **Custom middleware** | Logging, timestamps | Wrap `StateCreator` |
| **Immer** | Mutable update syntax | `immer()` middleware |
| **Subscriptions** | Side effects | `store.subscribe()` |

**See**: `references/advanced-topics.md` for complete implementations.

---

## Bundled Resources

| Type | Files |
|------|-------|
| **Templates** | `basic-store.ts`, `typescript-store.ts`, `persist-store.ts`, `slices-pattern.ts`, `devtools-store.ts`, `nextjs-store.ts`, `computed-store.ts`, `async-actions-store.ts` |
| **References** | `middleware-guide.md`, `typescript-patterns.md`, `nextjs-hydration.md`, `migration-guide.md`, `known-issues.md`, `common-patterns.md`, `advanced-topics.md` |

---

## When to Load References

| Reference | Load When... |
|-----------|--------------|
| `known-issues.md` | Debugging hydration, TypeScript, infinite loop, or slices errors |
| `common-patterns.md` | Implementing computed values, async actions, reset patterns |
| `advanced-topics.md` | Vanilla stores, custom middleware, Immer, subscriptions |
| `middleware-guide.md` | Configuring persist, devtools, or combining middlewares |
| `typescript-patterns.md` | Complex type inference issues, StateCreator problems |
| `nextjs-hydration.md` | Next.js SSR/hydration problems |
| `migration-guide.md` | Migrating from Redux, Context API, or Zustand v4 |

---

## Quick Troubleshooting

| Problem | Solution |
|---------|----------|
| Store updates don't trigger re-renders | Use selector: `useStore(state => state.value)` not destructuring |
| TypeScript errors with middleware | Use `create<T>()()` double parentheses |
| Hydration error with persist | Implement `_hasHydrated` flag pattern |
| Actions not showing in DevTools | Pass action name: `set(newState, undefined, 'actionName')` |
| Store resets unexpectedly | HMR causes reset in development |

---

## Dependencies

```json
{ "dependencies": { "zustand": "^5.0.14", "react": "^18.0.0+" } }
```

**Compatibility**: React 18+, React 19, TypeScript 5+, Next.js 14+, Vite 5+

---

**Official Docs**: https://zustand.docs.pmnd.rs/ | **GitHub**: https://github.com/pmndrs/zustand

© secondsky · MIT · secondsky/claude-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — zustand-state-management от других авторов.

zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок zustand-state-builder patricio0312rev Скилл zustand-state-builder для Claude Code управляет состоянием приложения через Zustand: лёгкий API, TypeScript, сохранение в хранилище и devtools. CX Codex +1 264установок state-management agent-skills Скилл state-management для Claude Code помогает настраивать загрузку данных, кэширование и клиентское состояние через React Query и Zustand. Активируется при работе с useQuery, useMutation и хранилищами Zustand. CX Codex +1 849установок frontend-state-management aj-geddes Скилл frontend-state-management для работы с состоянием фронтенда: подсказывает, как организовать Redux, MobX, Zustand или Context API в приложении. CX Codex +1 487установок zustand-state existential-birds Скилл zustand-state для Claude Code помогает создавать хранилища Zustand, выбирать данные селекторами, сохранять их в localStorage и подключать devtools. CX Codex +1 261установок zustand-patterns OrchestKit Скилл zustand-patterns для Claude Code помогает проектировать хранилища на Zustand 5.x с типизацией в TypeScript. Подключается при настройке слайсов, селекторов useShallow и цепочек middleware. CX Codex +1 1 500установок zustand-5 prowler-cloud Скилл с паттернами управления состоянием в Zustand 5: базовые хранилища, селекторы, persist-middleware и разделение логики на слайсы. Помогает писать чистый реактивный код без лишних ре-рендеров. CX Codex +1 912установок

Из того же набора138

Весь набор →
cloudflare-workers-multi-lang Скилл cloudflare-workers-multi-lang настраивает Cloudflare Workers на Rust, Python и WebAssembly. Помогает перенести вычисления в WASM и настроить сборку через wasm-pack. CX Codex +1 317установок cloudflare-r2 Работа с Cloudflare R2, S3-совместимым хранилищем объектов. Управляет бакетами, загрузками, CORS и подписанными ссылками. CX Codex +1 316установок cloudflare-workers-migration Скилл cloudflare-workers-migration для переноса приложений на Cloudflare Workers с AWS Lambda, Vercel, Express и Node.js. Автоматически адаптирует обработчики, middleware и переменные окружения под Web API. CX Codex +1 316установок tanstack-query Скилл помогает агенту работать с TanStack Query v5: получать данные, настраивать кэш, мутации и разбирать ошибки миграции с v4. CX Codex +1 314установок nextjs Скилл для работы с Next.js 16, React 19.2 и современными паттернами серверных компонентов, Server Actions и кэширования. Помогает при миграции с версии 15, ошибках async params и настройке Partial Prerendering. CX Codex +1 299установок feature-dev Скилл feature-dev для Claude Code ведёт разработку функции через семь фаз — от изучения кодовой базы до проверки результата. Охватывает многофайловые задачи и спорные архитектурные решения. CX Codex +1 294установок cloudflare-nextjs Скилл cloudflare-nextjs для Claude Code настраивает и развёртывает Next.js на Cloudflare Workers через OpenNext. Помогает переносить проект и разбирать ошибки среды Workers. CX Codex +1 267установок cloudflare-turnstile Скилл cloudflare-turnstile для Claude Code помогает добавить Turnstile и проверять токены на сервере. Подключается при настройке защиты форм или разборе ошибок виджета. CX Codex +1 261установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой