From eff5e2bdcfe7bd65e5cf8fdfa813a7cc826ac829 Mon Sep 17 00:00:00 2001
From: Esdras Renan <monkeyesdras@gmail.com>
Date: Mon, 20 Oct 2025 12:14:01 -0300
Subject: [PATCH] Document NSIS icon regeneration steps

---
 docs/DEV.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/DEV.md b/docs/DEV.md
index d6fc8f9..1d1eef0 100644
--- a/docs/DEV.md
+++ b/docs/DEV.md
@@ -137,6 +137,22 @@ pnpm -C apps/desktop tauri build
 
 Artefatos: `apps/desktop/src-tauri/target/release/bundle/`.
 
+#### Ícone do instalador (NSIS)
+
+- O Windows espera que `apps/desktop/src-tauri/icons/icon.ico` contenha sprites em 16, 24, 32, 48, 64, 128 e 256 px, todos com fundo transparente. Sem esses tamanhos o Explorer gera uma miniatura reduzida com bordas acinzentadas.
+- Para atualizar o ícone a partir do `icon-512.png`, execute:
+
+  ```bash
+  cd apps/desktop/src-tauri
+  python3 - <<'PY'
+from PIL import Image
+img = Image.open("icons/icon-512.png")
+img.save("icons/icon.ico", sizes=[(16,16),(24,24),(32,32),(48,48),(64,64),(128,128),(256,256)])
+PY
+  ```
+
+- Depois de regerar `icon.ico`, faça o commit e rode novamente `pnpm -C apps/desktop tauri build` para empacotar o instalador com o ícone correto.
+
 ### Atualizações OTA
 
 1. Gere chaves (`pnpm tauri signer generate`).