Skip to content

Build your personal knowledge base with Trilium Notes

docs(desktop): note Icon Composer build requirement and manual leaf upkeep

Anand Hegde136e4ee72e4c
diff --git a/docs/Developer Guide/Developer Guide/Building/Build deliveries locally.md b/docs/Developer Guide/Developer Guide/Building/Build deliveries locally.md
index 3c78ae4aa6..80bb6471c9 100644
--- a/docs/Developer Guide/Developer Guide/Building/Build deliveries locally.md
+++ b/docs/Developer Guide/Developer Guide/Building/Build deliveries locally.md
@@ -7,6 +7,8 @@ Go to `apps/desktop`, and:
* To only build the Flatpak, run `pnpm electron-forge:make-flatpak`.
* To only build without packaging it, run `pnpm electron-forge:package`.
+On macOS, packaging compiles the Icon Composer app icons (`app-icon/icon.icon`, `icon-dev.icon`) with `actool`, so it requires macOS 26 and Xcode 26 or newer. On older versions `@electron/packager` fails with an `actool` error rather than falling back to the `.icns` icon.
+
## Building the server
Go to `apps/server` and run `pnpm package` to run the build script. The built artifacts will appear in `apps/server/dist`, whereas the packaged build will be available in `apps/server/out`.
diff --git a/scripts/icons/create-icons.sh b/scripts/icons/create-icons.sh
index 164302c9c8..cfcb53f8d1 100644
--- a/scripts/icons/create-icons.sh
+++ b/scripts/icons/create-icons.sh
@@ -71,6 +71,11 @@ done
npx iconsur set fakeapp.app -l -i "png/1024x1024-dev.png" -o "mac/master-dev.png" -s 0.8
build_icns "mac/master-dev.png" "icon-dev.icns" "mac/dev"
+# icon.icon and icon-dev.icon (Icon Composer documents for macOS 26) are NOT generated here. Their
+# Assets/leaf-{right,bottom,left}.svg are the three path groups of icon-color.svg and
+# icon-purple.svg, one leaf per file on the same 256x256 viewBox, with each class resolved to its
+# fill color. After changing either source SVG, update those leaf files by hand to match.
+
# Build Windows icon
magick -background none "$source_icon_dir/icon-color.svg" -define icon:auto-resize=16,32,48,64,128,256 "./icon.ico"
magick -background none "$source_icon_dir/icon-purple.svg" -define icon:auto-resize=16,32,48,64,128,256 "./icon-dev.ico"