diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index d8475cd..d4b914e 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -2,9 +2,17 @@ packages:
   - server
   - web
 
+# pnpm 11/12: sem isto o install falha com ERR_PNPM_IGNORED_BUILDS,
+# porque o esbuild (usado pelo Vite) precisa rodar script de build. 
+allowBuilds:
+  esbuild: true
+
+# Chave equivalente para pnpm 9/10 (ignorada pelo pnpm 12).
 onlyBuiltDependencies:
   - esbuild
 
+# Overrides de segurança. Atenção: pnpm 9 e anterior ignoram esta seção
+# (o pnpm 10+ lê overrides de pnpm-workspace.yaml).
 overrides:
   fastify@<5.7.2: '>=5.7.2'
   fastify@<=5.7.2: '>=5.7.3'