packages/desktop/icons/README.md

Tauri icon workflow: save app-icon.png, run bun tauri icon per environment, regenerate icon.icns via Image2Icon for macOS shadow/padding, and keep unpacked-Electron dock.png synced with the packaged icon. Read when regenerating desktop icons.

Tauri Icons

Here's the process I've been using to create icons:

Save source image as app-icon.png in packages/desktop
cd to packages/desktop
Run bun tauri icon -o src-tauri/icons/{environment}
Use Image2Icon's 'Big Sur Icon' preset to generate an icon.icns file and place it in the appropriate icons folder

The Image2Icon step is necessary as the icon.icns generated by app-icon.png does not apply the shadow/padding expected by macOS, so app icons appear larger than expected.

For unpackaged Electron on macOS, app.dock.setIcon() should use a PNG. Keep dock.png in each channel folder synced with the extracted icon_128x128@2x.png from that channel's icon.icns so the dev Dock icon matches the packaged app inset.