Como você decide onde cada parte do estado deve ficar?

Question

Accepted Answer

Decidir **onde o estado fica** é uma das habilidades de arquitetura mais importantes. O princípio norteador: coloque cada parte do estado no **escopo mais estreito** que ainda satisfaz todos que precisam dele — e combine cada *tipo* de estado com a ferramenta correta.

## Um framework de decisão

```text
1. Who needs this state?
   - One component                  → local state (useState)
   - A few related components        → lift to common parent / small context
   - Many distant components         → global store or context

2. What KIND of state is it?
   - Server/remote data              → server-state library (React Query/SWR)
   - UI/client state                 → useState / Zustand / Redux
   - URL-derivable (filters, page)    → the URL (searchParams)
   - Form input                       → form library or local state

3. How OFTEN does it change?
   - Rarely, widely shared (theme)    → Context is fine
   - Frequently, widely shared        → store with selective subscriptions
```

## As categorias e suas casas

```text
State type     Lives in                       Examples
─────────────────────────────────────────────────────────────────
Local UI       component (useState)           input text, isOpen, hover
Shared UI      lifted parent / Context / store modal state, selected item
Server data    React Query / SWR / RTK Query  users, products (cached remote)
URL state      router / searchParams          filters, page, search query, tab
Form state     React Hook Form / local         field values, validation
Global app     Zustand / Redux / Context      auth user, theme, cart
```

## Erros comuns que o framework previne

```text
❌ Server data in Redux       → use React Query (it's a cache, not UI state)
❌ Everything global "just in case" → over-coupling, extra re-renders; keep local
❌ Filters/page in state       → put in the URL (shareable, bookmarkable, back-button)
❌ Duplicating derivable values → derive instead (single source of truth)
❌ Form state in a global store → usually overkill; keep local or use a form lib
```

## A URL é um estado subutilizado

```text
Filters, pagination, search, active tab → belong in the URL.
Benefits: shareable links, browser back/forward works, survives refresh, SEO.
```

## Por que isso importa

Onde o estado fica determina a simplicidade, desempenho e manutenibilidade de uma aplicação.

A habilidade é resistir ao impulso de tornar tudo global e, em vez disso, **localizar por padrão, combinando cada tipo de estado com sua ferramenta adequada** (dados de servidor → React Query, derivável da URL → a URL, UI → local/store).

Acertar isso evita os problemas de arquitetura mais comuns — dados de servidor metidos no Redux, estado super-globalizado causando re-renders e filtros no estado do componente em vez de na URL.

Este julgamento é o que separa uma arquitetura de estado limpa e escalável de uma bagunçada.