Files
solidcraft-upstream/assets/README.md
T

2.2 KiB

SolidCraft macOS icon

SolidCraft.icon/ is the approved Icon Composer source, containing separate grid and solid SVG layers and the owner's appearance settings. The saturated blue solid has transparent geometry cutouts instead of painted edge lines. The solid and grid are both scaled to 90%, with separate Default and Dark grid artwork. Icon Composer supplies the system backdrop and Mono material effects. Artwork is original and attributed in ATTRIBUTION.md.

Assets.car is compiled by Apple's actool and supplies the layered icon on macOS 26 and later. It is checked in so the existing release workflow can still package on older Xcode runners. After editing and saving SolidCraft.icon, regenerate the catalog with Xcode 26 or later from the repository root:

mkdir -p target/macos-icon
xcrun actool assets/SolidCraft.icon \
  --compile target/macos-icon --platform macosx \
  --minimum-deployment-target 11.0 --app-icon SolidCraft \
  --output-partial-info-plist target/macos-icon/icon-info.plist \
  --output-format human-readable-text
cp target/macos-icon/Assets.car assets/Assets.car
cp target/macos-icon/SolidCraft.icns assets/icon.icns

icon.icns is the older-macOS fallback generated by the same Apple compiler from the approved composition, retaining its layer sizes and positions. Regenerate both compiled resources together with the commands above. icon.vectorcraft, icon.svg, icon.png and icon.iconset/ retain the earlier VectorCraft artwork; packaging uses the Icon Composer compilation instead.

Only packaging/macos/package.sh consumes these resources. Its existing signed app/DMG workflow copies the catalog and ICNS into Contents/Resources, and Info.plist references SolidCraft through CFBundleIconName and CFBundleIconFile. The macOS viewport opts out of eframe's runtime bitmap so Finder, the Dock and the application switcher use the bundle icon. Other platforms retain the existing code-drawn icon and packaging.

Design references: Apple app-icon HIG and Icon Composer documentation. No Apple artwork is shipped.