Build your personal knowledge base with Trilium Notes
TypeScript electronelectron-appknowledge-baseknowledge-graphknowledge-managementknowledge-management-graphlocal-firstnote-managmentnote-takernote-takingnotebooknotesnotes-apppersonal-knowledge-basepersonal-wikiscriptableself-hostedself-hostingwiki
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.mdindex 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 serverGo 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.shindex 164302c9c8..cfcb53f8d1 100644--- a/scripts/icons/create-icons.sh+++ b/scripts/icons/create-icons.sh@@ -71,6 +71,11 @@ donenpx iconsur set fakeapp.app -l -i "png/1024x1024-dev.png" -o "mac/master-dev.png" -s 0.8build_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 iconmagick -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"