@kitkat-vn/kitcode 0.2.0-staging.6 → 0.2.0-staging.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitkat-vn/kitcode",
-  "version": "0.2.0-staging.6",
+  "version": "0.2.0-staging.7",
   "description": "Local aggregate activity server for KitCode.",
   "license": "MIT",
   "repository": {
@@ -37,5 +37,5 @@
   "optionalDependencies": {
     "electron": "^43.0.0"
   },
-  "gitHead": "db529cdd770406de653f0ab1a448c868cc0af68a"
+  "gitHead": "91818f8efdd897617e47dc344e5fe65fc596cbf0"
 }

package/src/app-identity.mjs

@@ -0,0 +1,29 @@
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+// The name and icon of KitCode's Electron windows, Welcome and the Mini (the operator, 2026-10-03): "KitCode Companion",
+// and the web dashboard's favicon, rendered as a 512 × 512 PNG, which Electron reads where it cannot read an SVG.
+//
+// What it changes: the app's name for Electron (menus, notifications), the Dock's icon on macOS while a window is open,
+// and each window's icon on Windows and Linux. What it cannot: the Dock's label on macOS, which is the running bundle's
+// name, Electron's own, until KitCode ships an app bundle of its own.
+export const APP_NAME = 'KitCode Companion';
+export const ICON_PATH = path.join(path.dirname(fileURLToPath(import.meta.url)), 'assets', 'kitcode-icon.png');
+
+// Called before the app is ready: the name. Never throws: a window opens without it.
+export function nameApp(app) {
+  try {
+    app.setName(APP_NAME);
+  } catch {
+    // The name is cosmetic.
+  }
+}
+
+// Called once the app is ready: the Dock's icon on macOS. Never throws.
+export function showAppIcon(app) {
+  try {
+    app.dock?.setIcon(ICON_PATH);
+  } catch {
+    // The icon is cosmetic.
+  }
+}

package/src/companion-electron.mjs

@@ -1,4 +1,5 @@
 import {app, BrowserWindow, ipcMain, nativeTheme, screen, shell} from 'electron';
+import {ICON_PATH, nameApp, showAppIcon} from './app-identity.mjs';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {reachableAddress} from './api-access.mjs';
@@ -39,6 +40,7 @@ async function trackerReady() {
 function createMiniWindow(url) {
   const position = miniPosition();
   miniWindow = new BrowserWindow({
+    icon: ICON_PATH,
     width: miniWidth, height: miniHeight,
     minWidth: miniWidth, minHeight: miniHeight, maxWidth: miniWidth, maxHeight: miniHeight,
     x: position.x, y: position.y, frame: false, transparent: true, hasShadow: false,
@@ -58,7 +60,10 @@ function createMiniWindow(url) {
   miniWindow.loadURL(url);
 }
 
+nameApp(app);
+
 app.whenReady().then(async () => {
+  showAppIcon(app);
   nativeTheme.themeSource = 'dark';
   const connected = await trackerReady();
   const miniUrl = connected

package/src/companion-window.mjs

@@ -11,7 +11,7 @@ ${fontFaces(['vt323', 'fira-code'])}
 *{box-sizing:border-box;margin:0;padding:0}
 html,body{position:relative;width:100%;height:100%;margin:0;overflow:hidden;background:transparent;color:var(--white-text);font-family:var(--font-mono)}
 button{cursor:pointer}
-.widget-window{position:relative;width:100%;height:100%;display:flex;flex-direction:column;background:var(--bg-color);border:2px solid var(--red-color);border-radius:8px;overflow:hidden;-webkit-app-region:drag}
+.widget-window{position:relative;width:100%;height:100%;display:flex;flex-direction:column;background:var(--bg-color);border:2px solid var(--red-color);border-radius:0;overflow:hidden;-webkit-app-region:drag}
 .title-bar{padding:6px 10px 4px;display:flex;align-items:center;gap:7px;border-bottom:1px solid var(--red-color)}
 .dot{width:12px;height:12px;border-radius:50%;border:1px solid var(--red-color);background:transparent}
 .dot.filled{background-color:var(--red-color)}

package/src/onboarding-electron.mjs

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import {spawn} from 'node:child_process';
 import {app, BrowserWindow, dialog, ipcMain, nativeTheme} from 'electron';
+import {ICON_PATH, nameApp, showAppIcon} from './app-identity.mjs';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {describeProjects, listProjectRecords, registerNewProjects, removeProject, resolveInitialProjectSuggestion} from './runtime.mjs';
@@ -136,7 +137,10 @@ function setupWindowOptions(platform) {
   };
 }
 
+nameApp(app);
+
 app.whenReady().then(() => {
+  showAppIcon(app);
   if (!gotSingleInstanceLock) {
     return;
   }
@@ -146,7 +150,7 @@ app.whenReady().then(() => {
   if (platform === 'darwin') {
     app.dock?.hide();
   }
-  window = new BrowserWindow(setupWindowOptions(platform));
+  window = new BrowserWindow({...setupWindowOptions(platform), icon: ICON_PATH});
   keepWindowOnItsPage(window);
   // Project records carry absolute paths: only Welcome's own page gets them.
   ipcMain.handle('kitcode:onboarding-initial-state', (event) => {