diff --git a/README.md b/README.md
index 28bb079..fc3cfe3 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,10 @@ npm run package:mac
 Only rebuild if source code has changed. The `.app` bundle is identical for all Intel laptops —
 only `~/seed.json` differs per device.
 
+> **Note:** The build will print `WARNING: Could not find icon "..." with extension ".icon"`. This
+> is cosmetic — `electron-packager` checks for several icon format variants and warns for each it
+> doesn't find. The `.icns` file is correctly embedded as `electron.icns` inside the app bundle.
+
 ### Step 2 — Create event.env
 
 ```bash