Repository navigation
macOS DMG: branded window background and icon layout - #131
Merged
Merged
Conversation
This was referenced Oct 8, 2026
XusBadia
force-pushed
the
dmg-background
branch
3 times, most recently
from
October 8, 2026 15:57
c48c791 to
22612c7
Compare
The DMG opened as a plain Finder window. It now shows the app icon's figure on the DesignCraft colour, with DesignCraft.app and the Applications link side by side. Same approach as PhotoCraft's and VectorCraft's (storytold/photocraft#1201, storytold/vectorcraft#493). - packaging/macos/dmg/: background.svg (source; text outlined, no paper grain, the figure an <image> of assets/app-icon), background.tiff (1x + 2x HiDPI, 16-colour palette, Deflate, sRGB; ~90 KB) and dmg-layout.DS_Store (Finder view settings: window, icon size 128, positions, background). - generate.py writes the TIFF and the layout on any OS, byte-for-byte reproducible, with nothing from the machine that ran it (no paths, users, disk names or volume UUIDs). - package.sh copies them into the staging folder; the image is still built with hdiutil makehybrid. Nothing extra runs in the signing job. - The volume name drops the version: the layout finds the background through an alias that includes the volume name. The DMG file name keeps the version. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
XusBadia
force-pushed
the
dmg-background
branch
from
October 9, 2026 05:43
22612c7 to
ec42e54
Compare
Member
|
Merged — thank you @XusBadia! The branded DMG window looks great, and thanks for doing the whole Crafting Apps suite with each app's own icon and colour. We'd love to have you in the community Discord if you're not already there: https://discord.gg/artcraft |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The macOS DMG opened as a plain white Finder window. It now opens like this:
The icon's figure as a cover on the DesignCraft colour field, DesignCraft.app and the
Applicationslink side by side on Paper, and a small DesignCraft-specific touch: the arrow and the mono line under the title come from the app's craft. Ink, Paper and the app colour only; Inter and JetBrains Mono.How
Same approach as PhotoCraft's and VectorCraft's, which have landed (storytold/photocraft#1201, storytold/vectorcraft#493):
packaging/macos/dmg/background.svg: the source. Its text is outlined, so rendering it needs no fonts, and the figure is an<image>of the existing icon inassets/app-icon/.background.tiff: 1x 660×400 + 2x 1320×800 in one HiDPI TIFF (16-colour palette, Deflate, sRGB; 90 KB). No paper grain: noise doesn't compress, and this keeps the binary small.dmg-layout.DS_Store: Finder's view settings (window 660×400 content, icon size 128, DesignCraft.app at (326, 205), Applications at (574, 205), the background). It's named so it isn't mistaken for, or ignored like, a Finder-generated.DS_Store.generate.py: writes both from the SVG on any OS (pip install 'pillow>=12' ds_store==1.3.3 mac_alias==2.2.3, resvg on PATH). The output is byte-for-byte reproducible and carries nothing from the machine that ran it: no paths, users, disk names or volume UUIDs.package.shcopies the TIFF and the layout into the staging folder. The image is still built withhdiutil makehybrid, and nothing extra runs in the signing job.One behaviour change: the volume name drops the version
.DS_Storepoints at the background through an alias that includes the volume name. WithDesignCraft <version>Finder kept the window and icon positions but lost the background (tested). So the mounted volume is now calledDesignCraft; the DMG file name still carries the version.Tested
package.shsteps (staging folder,makehybrid, UDZO) around a stubDesignCraft.appwith the real icon, mounted it and opened it in Finder on macOS: the screenshot above is that DMG.shellcheckclean;cargo xtask assetspasses where the repo has it;generate.pyreproduces the committed files byte for byte (6 runs).Across the suite
Matching PRs for every Crafting App, same layout, each with its own figure and colour:
🤖 Generated with Claude Code