Clase 02 · Módulo 06
Estado global con Zustand
Estado global con Zustand
Qué logras en esta clase
Lees, pides y revisas un almacén de estado global hecho con Zustand, y sabes cuándo no usarlo.
- Entiendes las tres partes de un store: datos, acciones y
set. - Lees estado con selectores para no redibujar de más.
- Haces que un store sobreviva al cierre de la app.
02
El problema: datos que viajan de mano en mano
El carrito de una cafetería lo necesitan la pantalla del menú, la del producto, la barra inferior y la de pago.
Con lo visto en el módulo 4, tendrías que guardarlo en un componente que las contenga a todas y pasarlo como prop, nivel por nivel, hasta donde se usa. Los componentes del medio reciben datos que no les interesan, solo para entregarlos al siguiente.
03
La idea de un store
Un store es una caja con datos y funciones que cualquier pantalla puede leer directamente, sin que nadie se la pase.
04
Qué es Zustand
Zustand es una librería pequeña de estado global para React. Creas el store en un archivo y cualquier componente lo usa como un hook (visto en el módulo 4). No necesita envolver la app en un proveedor.
No trae código nativo: instalarla no te obliga a recompilar el development build.
npx expo install zustand05
Otras formas de compartir estado
| Opción | Cuándo conviene |
|---|---|
| Props o parámetros de ruta | Dos pantallas vecinas que se pasan un dato |
| Context de React | Un valor que casi no cambia, como el tema |
| Zustand | Estado compartido que cambia seguido |
| Redux Toolkit | Equipos grandes que ya lo usan |
Context viene incluido en React, pero cada cambio redibuja a todos los que lo leen. Por eso para un carrito conviene un store.
06
Anatomía de un store
import { create } from 'zustand'
export const useCarrito = create((set) => ({
items: [],
agregar: (id) =>
set((estado) => ({ items: [...estado.items, id] })),
vaciar: () => set({ items: [] }),
}))create recibe una función y devuelve un hook. Por convención su nombre parte con use. En tu proyecto Claude le agregará además el tipo de TypeScript que describe el store.
07
Las tres partes que debes reconocer
- Datos:
items. El valor inicial es una lista vacía. - Acciones:
agregaryvaciar. Son las únicas formas permitidas de cambiar los datos. set: la función que Zustand te entrega para aplicar el cambio y avisar a las pantallas.
Que los cambios pasen solo por acciones con nombre es lo que hace legible el store: para saber qué puede pasarle al carrito, lees la lista de acciones.
08
set fusiona, no reemplaza
set({ items: [] }) cambia solo items. Las demás claves del store quedan como estaban.
Cuando el valor nuevo depende del anterior, se pasa una función: set((estado) => ...). Así se agrega un producto sin perder los que ya había.
09
Leer el store desde una pantalla
const cantidad = useCarrito((estado) => estado.items.length)
const agregar = useCarrito((estado) => estado.agregar)La función que le pasas al hook se llama selector: elige qué pedazo del store quiere este componente. La barra inferior pide solo la cantidad; el botón pide solo la acción.
10
Para qué sirve el selector
Con un selector, la pantalla solo se redibuja cuando cambia el pedazo que eligió.
11
Error: traer el store completo
const carrito = useCarrito()Sin selector, el componente se suscribe a todo. Cualquier cambio en cualquier clave lo redibuja, aunque no use ese dato.
12
Del toque a la pantalla
Nadie le avisa a mano a la barra inferior que el carrito creció. Se entera porque su selector devuelve un número distinto.
13
Qué va en un store y qué no
| Va | No va |
|---|---|
| Carrito, filtros de toda la app | Datos traídos del servidor |
| Paso actual de un asistente | Texto de un campo de formulario |
| Preferencias de interfaz | Valores que se calculan |
| Datos de un flujo de varias pantallas | Contraseñas y tokens |
El total del carrito se calcula con un selector a partir de items; no se guarda como dato aparte.
14
Varios stores pequeños, no uno gigante
Zustand permite crear todos los stores que quieras. Uno por tema se lee mejor que uno con todo:
useCarrito: productos elegidos.usePreferencias: tema, unidad de medida.useReserva: datos de un asistente de tres pasos.
15
Sobrevivir al cierre: el middleware persist
Un store vive en memoria: al cerrar la app, el carrito vuelve a estar vacío. Zustand trae persist, un envoltorio que lo guarda en disco y lo recupera al abrir.
persist(creador, {
name: 'carrito',
storage: createJSONStorage(() => AsyncStorage),
})name es la clave bajo la que se guarda. storage dice dónde. Sin indicarlo usa el almacenamiento del navegador, que en un teléfono no existe.
16
Guardar solo lo necesario
Dos opciones de persist que conviene conocer:
partialize: elige qué claves se guardan. Un indicador de «enviando» no debe sobrevivir al cierre.versionymigrate: cuando cambias la forma del store, subes la versión y describes cómo convertir lo guardado antes.
17
El primer dibujo llega antes que el disco
Leer del disco en el teléfono es asíncrono. Durante un instante al abrir la app, el store tiene sus valores iniciales y no los guardados.
Consecuencia típica: el carrito parpadea vacío, o la app decide algo con un dato que aún no cargó.
La solución es una marca de «ya cargué» que se enciende al terminar la lectura (onRehydrateStorage), y esperar esa marca antes de dibujar lo que depende del store.
18
Nada secreto en un store persistido
AsyncStorage guarda texto sin cifrar. Un store persistido ahí sirve para carrito, preferencias y borradores.
19
Cuándo no necesitas Zustand
| Situación | Mejor opción |
|---|---|
| El dato lo usa una sola pantalla | useState |
| Una pantalla le pasa un id a la siguiente | Parámetro de ruta (módulo 5) |
| El dato viene del servidor | TanStack Query (clase 3) |
| Un valor fijo, como los colores | Una constante |
Una app puede llegar a las tiendas con uno o dos stores chicos. Muchos stores suele ser señal de datos del servidor copiados donde no corresponde.
20
Lo bueno y lo malo
- A favor: poco código, fácil de leer, sin proveedor, redibuja solo lo necesario si usas selectores.
- En contra: no impone orden. Nada te impide meter todo en un store, y la librería no te avisa.
- Límite: no sabe nada de servidores. No tiene «cargando», reintentos ni caché.
La disciplina la pones tú, con las reglas de esta clase.
21
Cómo revisar un store que escribió Claude
- Lee las acciones: ¿describen todo lo que puede pasarle a ese dato?
- Busca datos del servidor guardados ahí. No deberían estar.
- Busca valores calculados guardados como dato.
- Revisa que las pantallas usen selectores.
- Si persiste: ¿qué claves guarda y dónde?, ¿espera la carga inicial?
Si algo no calza, pídele a Claude que explique por qué ese dato es global.
22
Lo que te llevas
- Un store reúne datos y acciones que cualquier pantalla usa sin recibirlos por props.
setfusiona el primer nivel; los cambios pasan por acciones con nombre.- Los selectores evitan redibujar de más.
persistguarda el store en disco; la carga es asíncrona y hay que esperarla.- Datos del servidor y secretos no van en un store.
23
Hazlo ahora
En 15 minutos, en tu proyecto:
- Elige un dato global de tu tabla de la clase 1.
- Pídele a Claude Code un store de Zustand solo para ese dato, con acciones con nombre.
- Revísalo con los cinco puntos de la revisión.
- Cámbialo desde una pantalla y comprueba que otra se actualiza.
- Cierra la app por completo y ábrela: ¿se perdió? Decide si debe persistirse.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026