From 9248919b054a3268bc0d141e5ca3519bcfcf2221 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 19 Dec 2025 22:39:30 +0100
Subject: [PATCH] docs: note DMG background sizing

---
 docs/mac/bun.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/mac/bun.md b/docs/mac/bun.md
index d57e31f92..d8d41775f 100644
--- a/docs/mac/bun.md
+++ b/docs/mac/bun.md
@@ -126,3 +126,11 @@ pnpm -s clawdis gateway call health --url ws://127.0.0.1:18999 --timeout 3000
 Bun may leave dotfiles like `*.bun-build` in the repo root or subfolders.
 - These are ignored via `.gitignore` (`*.bun-build`).
 
+## DMG styling (human installer)
+
+`scripts/create-dmg.sh` styles the DMG via Finder AppleScript.
+
+Rules of thumb:
+- Use a **72dpi** background image that matches the Finder window size in points.
+- Preferred asset: `assets/dmg-background-small.png` (**500×320**).
+- Default icon positions: app `{125,160}`, Applications `{375,160}`.