react-native-state

Master state management - Redux Toolkit, Zustand, TanStack Query, and data persistence

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for mastering React Native state management, covering industry-standard tools like Redux Toolkit, Zustand, and TanStack Query. It focuses on building scalable mobile architectures by implementing efficient global state, server-side data synchronization, and high-performance local data persistence using AsyncStorage and MMKV.

Use Cases

  • Architecting complex React Native applications by selecting and implementing the most suitable state management patterns (Redux, Zustand, or Context).
  • Managing server-side state and caching strategies with TanStack Query to ensure seamless data synchronization and offline support.
  • Implementing robust data persistence layers with MMKV or AsyncStorage to maintain user sessions and application preferences across restarts.
  • Refactoring legacy React Native codebases to modern, type-safe state management solutions using TypeScript and Redux Toolkit.
namereact-native-state
descriptionMaster state management - Redux Toolkit, Zustand, TanStack Query, and data persistence
sasmp_version"1.3.0"
bonded_agent03-react-native-state
bond_typePRIMARY_BOND
version"2.0.0"
updated"2025-01"

React Native State Management Skill

Learn production-ready state management including Redux Toolkit, Zustand, TanStack Query, and persistence with AsyncStorage/MMKV.

Prerequisites

  • React Native basics
  • TypeScript fundamentals
  • Understanding of React hooks

Learning Objectives

After completing this skill, you will be able to:

  • Set up Redux Toolkit with TypeScript
  • Create Zustand stores with persistence
  • Manage server state with TanStack Query
  • Persist data with AsyncStorage/MMKV
  • Choose the right solution for each use case

Topics Covered

1. Redux Toolkit Setup

// store/index.ts
import { configureStore } from '@reduxjs/toolkit';
import { authSlice } from './slices/authSlice';

export const store = configureStore({
  reducer: {
    auth: authSlice.reducer,
  },
});

export type RootState = ReturnType<typeof store.getState>;
export type AppDispatch = typeof store.dispatch;

2. RTK Slice

import { createSlice, PayloadAction } from '@reduxjs/toolkit';

interface AuthState {
  user: User | null;
  token: string | null;
}

export const authSlice = createSlice({
  name: 'auth',
  initialState: { user: null, token: null } as AuthState,
  reducers: {
    setUser: (state, action: PayloadAction<User>) => {
      state.user = action.payload;
    },
    logout: (state) => {
      state.user = null;
      state.token = null;
    },
  },
});

3. Zustand Store

import { create } from 'zustand';
import { persist, createJSONStorage } from 'zustand/middleware';
import AsyncStorage from '@react-native-async-storage/async-storage';

interface AppStore {
  theme: 'light' | 'dark';
  setTheme: (theme: 'light' | 'dark') => void;
}

export const useAppStore = create<AppStore>()(
  persist(
    (set) => ({
      theme: 'light',
      setTheme: (theme) => set({ theme }),
    }),
    {
      name: 'app-storage',
      storage: createJSONStorage(() => AsyncStorage),
    }
  )
);

4. TanStack Query

import { useQuery, useMutation } from '@tanstack/react-query';

export function useProducts() {
  return useQuery({
    queryKey: ['products'],
    queryFn: () => api.getProducts(),
    staleTime: 1000 * 60 * 5, // 5 minutes
  });
}

export function useCreateProduct() {
  const queryClient = useQueryClient();

  return useMutation({
    mutationFn: api.createProduct,
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['products'] });
    },
  });
}

5. When to Use What

Solution Use Case
useState/useReducer Component-local state
Zustand Simple global state, preferences
Redux Toolkit Complex app state, large teams
TanStack Query Server state, caching, sync
Context Theme, auth status (low-frequency)

Quick Start Example

// Zustand + TanStack Query combo
import { create } from 'zustand';
import { useQuery } from '@tanstack/react-query';

// UI state with Zustand
const useUIStore = create((set) => ({
  sidebarOpen: false,
  toggleSidebar: () => set((s) => ({ sidebarOpen: !s.sidebarOpen })),
}));

// Server state with TanStack Query
function ProductList() {
  const { data, isLoading } = useQuery({
    queryKey: ['products'],
    queryFn: fetchProducts,
  });

  const sidebarOpen = useUIStore((s) => s.sidebarOpen);

  // Render with both states
}

Common Errors & Solutions

Error Cause Solution
"Non-serializable value" Functions in Redux state Use middleware ignore
State not persisting Wrong storage config Check persist config
Stale data Missing invalidation Add proper query keys

Validation Checklist

  • State updates correctly
  • Persistence works across restarts
  • Server state syncs properly
  • TypeScript types are correct

Usage

Skill("react-native-state")

Bonded Agent: 03-react-native-state