You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit e604c8d
Browse filesBrowse the repository at this point in the historyBrowse files
Use Icon Composer's native pre-Tahoe preset for the tracked macOS assets, keep the headless exporter from replacing them with full-bleed renders, and document the Codex-assisted workflow.
Co-authored-by: codex <[email protected]>
Copy file name to clipboardExpand all lines: assets/README.md
+36-1Lines changed: 36 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,8 +8,43 @@ The three Icon Composer projects are the source of truth for full application ic
8
8
9
9
Each project uses `text.svg` for the T3 mark and `background.svg` when the background is a vector layer. Additional layers use semantic names that describe their role and placement.
10
10
11
-
Run `vp run icons:export` from the repository root to regenerate the tracked PNG and ICO assets for mobile, desktop, and web. Run `vp run icons:check` to verify that the generated assets match their sources without changing files.
11
+
Run `vp run icons:export` from the repository root to regenerate the tracked iOS, Linux, Windows, and web assets. Run `vp run icons:check` to verify that those generated assets match their sources without changing files.
12
12
13
13
Exporting requires Icon Composer 2 or newer on macOS. The script selects the newest compatible exporter from Xcode or a standalone Icon Composer installation and pins design generation 26. Set `ICON_COMPOSER_TOOL` to the full path of `Icon Composer.app/Contents/Executables/ictool` to override automatic discovery.
14
14
15
+
## macOS exports
16
+
17
+
Icon Composer's command-line exporter does not expose the `macOS pre-Tahoe` preset. A plain command-line `macOS` export is full bleed and is not suitable for the desktop app, so the export script intentionally leaves the tracked macOS PNGs unchanged and prints a reminder after every run.
18
+
19
+
After changing an Icon Composer project, open it in Icon Composer and export the macOS PNG with exactly these settings:
The result must be a 1024×1024 PNG with the classic macOS safe area: the opaque icon body is 824×824, inset 100 pixels on every side, with only the native Icon Composer shadow extending into the surrounding transparent canvas.
33
+
34
+
To have Codex perform the native exports, paste this prompt into a task opened at the repository root:
35
+
36
+
```text
37
+
Use [@Computer](plugin://computer-use@openai-bundled) and the Icon Composer app to export the three macOS app icons in this repository.
38
+
39
+
For each project below, use Platform: macOS pre-Tahoe, Appearance: Default, Size: 1024pt, and Scale: 1×, then save the PNG to the exact destination:
Do not resize, composite, or otherwise post-process the exported PNGs.
46
+
47
+
Verify every result is 1024×1024 and has the classic macOS safe area: an 824×824 opaque body inset 100px on every side, with only Icon Composer's native shadow extending beyond it.
48
+
```
49
+
15
50
Do not edit the generated PNG or ICO files directly.
"Use [@Computer](plugin://computer-use@openai-bundled) and the Icon Composer app to export the three macOS app icons in this repository.",
252
+
"For each project below, use Platform: macOS pre-Tahoe, Appearance: Default, Size: 1024pt, and Scale: 1×, then save the PNG to the exact destination:",
"Do not resize, composite, or otherwise post-process the exported PNGs.",
255
+
"Verify every result is 1024×1024 and has the classic macOS safe area: an 824×824 opaque body inset 100px on every side, with only Icon Composer's native shadow extending beyond it.",
0 commit comments