Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

feat(open-knowledge): custom DMG install window for desktop app (#1542)

Andrew Mikofalvy21cf9026818b
diff --git a/.changeset/desktop-dmg-install-window.md b/.changeset/desktop-dmg-install-window.md
new file mode 100644
index 000000000..fc4161cf7
--- /dev/null
+++ b/.changeset/desktop-dmg-install-window.md
@@ -0,0 +1,7 @@
+---
+"@inkeep/open-knowledge-desktop": patch
+---
+
+Custom DMG install window: the mounted disk image now shows the standard "drag the app onto Applications" layout, with the app icon and the `/Applications` alias positioned over a background image.
+
+Configured via electron-builder's `dmg` block (installer-window size, icon coordinates, `background`). The committed background is a schematic placeholder; final branded artwork drops into `packages/desktop/build/dmg-background.png` + `[email protected]` (540x380 / 1080x760). Iterate on the layout locally with `bun run build:mac:unsigned`.
diff --git a/packages/desktop/build/dmg-background.png b/packages/desktop/build/dmg-background.png
new file mode 100644
index 000000000..4a8ae6c54
Binary files /dev/null and b/packages/desktop/build/dmg-background.png differ
diff --git a/packages/desktop/build/[email protected] b/packages/desktop/build/[email protected]
new file mode 100644
index 000000000..27a5f90db
Binary files /dev/null and b/packages/desktop/build/[email protected] differ
diff --git a/packages/desktop/electron-builder.yml b/packages/desktop/electron-builder.yml
index 98ab08c9c..425ffeea1 100644
--- a/packages/desktop/electron-builder.yml
+++ b/packages/desktop/electron-builder.yml
@@ -238,6 +238,27 @@ dmg:
# because we only ship arm64 today; an x64 / universal build would need
# a parallel artifactName + a splash decision rule.
artifactName: ${productName}-${arch}.${ext}
+ title: ${productName}
+ # The "drag me to Applications" arrow and branding are painted INTO the
+ # background art — Finder only composites the .app icon and the /Applications
+ # alias on top of it, at the `contents` coordinates below. `window` sets the
+ # installer-window size, and the 1x art must match it exactly. A sibling
+ # `build/[email protected]` at twice these dimensions (1080x760) supplies
+ # the Retina representation and is auto-composited by electron-builder when it
+ # sits next to the 1x file.
+ background: build/dmg-background.png
+ window:
+ width: 540
+ height: 380
+ contents:
+ - x: 140
+ y: 130
+ type: file
+ - x: 400
+ y: 130
+ type: link
+ path: /Applications
+ iconSize: 100
# Flip fuses (D17 LOCKED, spec §8.9) on the packed .app before code signing.
afterPack: scripts/afterPack.mjs