npm ERRESOLVE / peer dependencies — guia completo

1. Por que acontece

A partir do npm 7, peer dependencies são tratadas com mais rigor. Um plugin pode exigir React 18 enquanto o app está em 19.

npm install
# ERRESOLVE unable to resolve dependency tree
npm ls react
npm explain react

2. Estratégias (da melhor à paliativa)

1. Atualizar o pacote que declara o peer antigo
2. Alinhar a versão do peer no app (quando seguro)
3. Usar overrides no package.json com consciência
4. npm i --legacy-peer-deps só como paliativo local/CI temporário

// package.json
"overrides": {
  "algum-plugin": { "react": "$react" }
}

← erros