AgentSkillsCN

zustand-store-ts

使用TypeScript构建Zustand状态管理器，搭配subscribeWithSelector中间件，实现状态与动作的合理分离。适用于构建React状态管理逻辑、创建全局状态存储，或实施反应式…

SKILL.md
--- frontmatter
name: zustand-store-ts
description: "Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reacti..."
risk: unknown
source: community

Zustand Store

Create Zustand stores following established patterns with proper TypeScript types and middleware.

Quick Start

Copy the template from assets/template.ts and replace placeholders:

  • •{{StoreName}} → PascalCase store name (e.g., Project)
  • •{{description}} → Brief description for JSDoc

Always Use subscribeWithSelector

typescript
import { create } from 'zustand';
import { subscribeWithSelector } from 'zustand/middleware';

export const useMyStore = create<MyStore>()(
  subscribeWithSelector((set, get) => ({
    // state and actions
  }))
);

Separate State and Actions

typescript
export interface MyState {
  items: Item[];
  isLoading: boolean;
}

export interface MyActions {
  addItem: (item: Item) => void;
  loadItems: () => Promise<void>;
}

export type MyStore = MyState & MyActions;

Use Individual Selectors

typescript
// Good - only re-renders when `items` changes
const items = useMyStore((state) => state.items);

// Avoid - re-renders on any state change
const { items, isLoading } = useMyStore();

Subscribe Outside React

typescript
useMyStore.subscribe(
  (state) => state.selectedId,
  (selectedId) => console.log('Selected:', selectedId)
);

Integration Steps

  1. •Create store in src/frontend/src/store/
  2. •Export from src/frontend/src/store/index.ts
  3. •Add tests in src/frontend/src/store/*.test.ts

When to Use

This skill is applicable to execute the workflow or actions described in the overview.