From 4d9489b5ac308e6384e9036570147999ee4a2e15 Mon Sep 17 00:00:00 2001
From: Avi <avi@aiolabs.com>
Date: Mon, 24 Aug 2026 11:34:47 -0500
Subject: [PATCH] Checkpoint: app icon

---
 CHECKPOINT-encryption.md | 73 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 1 deletion(-)

diff --git a/CHECKPOINT-encryption.md b/CHECKPOINT-encryption.md
index 0407a61..c95413f 100644
--- a/CHECKPOINT-encryption.md
+++ b/CHECKPOINT-encryption.md
@@ -1,4 +1,75 @@
-# Checkpoint — Security dependency upgrades (2026-08-24)
+# Checkpoint — App icon (2026-08-24)
+
+A stopping point you can return to if this session is closed. Everything below was
+verified green at the moment this file was written.
+
+## Where things are
+
+- Project: `/home/avi/Projects/Nostr_Keynctr`
+- Git repo: `master` @ `8a644af` ("App icon: hummingbird-key mark for window
+  and packaged Linux builds"). Before it: `c11ab9f` (security dependency
+  upgrades), `48efaad` (checkpoint), `8bce428` (updates card).
+- Working tree: clean apart from this checkpoint update. Note: `concept3.svg`
+  shows as deleted in the working tree and `KeynectrAppIconPossibility02.jpeg`
+  (the icon source art) is untracked — both left as the user had them, not committed.
+
+## What was completed
+
+1. **App icon (2026-08-24, `8a644af`).** The hummingbird-key artwork
+   (`KeynectrAppIconPossibility02.jpeg`) is now the app icon everywhere:
+   - `frontend/build/icon.png` — 512×512 PNG used by electron-builder for
+     packaged Linux builds (`build.linux.icon`), i.e. desktop entries/installers.
+   - `frontend/public/icon.png` — copied by Vite into `dist/`, shipped inside
+     the packaged asar; `BrowserWindow({ icon })` loads it at runtime in both
+     dev (`public/`) and packaged (`dist/`) modes.
+   - Verified end-to-end: `npm run dist` produced `release/linux-unpacked`
+     with the icon inside `app.asar` (`/dist/icon.png`).
+2. Earlier today: all npm security advisories cleared via major upgrades
+   (`c11ab9f`), Updates card (`8bce428`), feed profile filter (`55a49b4`),
+   publish latency trim (`b001b3c`).
+
+## Commits added most recently
+
+- `8a644af` App icon: hummingbird-key mark for window and packaged Linux builds
+
+## Verification commands run (all green)
+
+Frontend (`frontend/`):
+
+```
+npm test             # 14 files, 91 tests passed
+npm run typecheck    # clean
+npm run lint         # 0 errors
+npm run format:check # clean
+npm run build        # vite build success (dist/icon.png present)
+npm run electron:build  # tsc electron main success
+npm run dist         # electron-builder linux dir target packaged OK (electron 43.4.1)
+```
+
+## How to use / reproduce
+
+```bash
+cd ~/Projects/Nostr_Keynctr/frontend
+npm start            # dev window shows the icon
+npm run dist         # packaged app in release/linux-unpacked (icon in asar)
+```
+
+To change the artwork later: overwrite `frontend/build/icon.png` and
+`frontend/public/icon.png` (512×512 PNG), rebuild.
+
+## Notes & next steps
+
+- The source JPEG has a white background (kept as-is). If a transparent
+  version is ever wanted for dark taskbars, regenerate the PNGs from a
+  transparent source.
+- Sharing decision (this session): user chose "shared access on same machine" —
+  the current single-vault + passcode model already covers it; no new sharing
+  feature needed. Distribution to others = `npm run dist` + their own passcode.
+- Relay health (earlier today): damus.io 503, nostr.band WS handshake timing out.
+
+---
+
+# Older checkpoint — Security dependency upgrades (2026-08-24)
 
 A stopping point you can return to if this session is closed. Everything below was
 verified green at the moment this file was written.