App Icons

Set up proper icons for your Local.ts application across all platforms and contexts.

Setting up proper icons ensures your application looks professional across all platforms and contexts.

Desktop Icons

Desktop icons are used for the application window, taskbar, and installers on Windows, macOS, and Linux.

Generate Icons

Use the Tauri Icon Generator to create icons for all platforms from a single source image:

Prepare your source image
- Format: PNG
- Size: 1024x1024 pixels minimum
- Background: Transparent (recommended)

Generate icons

turbo tauri -- icon path/to/your-icon.png

Output location The generated icons will be placed in src-tauri/icons/ with these files:
- 32x32.png, 128x128.png, 128x128@2x.png — Windows
- icon.icns — macOS
- icon.ico — Windows
- icon.png — Linux

The icon generator automatically creates all necessary sizes and formats. You only need to provide one high-quality source image.

Manual Icon Placement

If you already have platform-specific icons, place them directly in src-tauri/icons/:

src-tauri/
└── icons/
    ├── 32x32.png
    ├── 128x128.png
    ├── 128x128@2x.png
    ├── icon.icns      (macOS)
    ├── icon.ico       (Windows)
    └── icon.png       (Linux, 512x512)

Updating Icons

After changing icons:

Clear cache (if icons don't update immediately):
```
rm -rf src-tauri/target
```
Rebuild the app:
```
turbo tauri -- build
```

Best Practices

Use high-resolution source images — Start with at least 1024x1024px
Keep it simple — Icons should be recognizable at small sizes (16x16)
Use transparency — PNG with transparent backgrounds look better
Test on all platforms — Verify icons appear correctly on Windows, macOS, and Linux
Consistent branding — Use the same visual identity across desktop and web icons

Troubleshooting

Icons not showing in built app

Make sure icon paths in src-tauri/tauri.conf.json are correct:

{
  "tauri": {
    "bundle": {
      "icon": [
        "icons/32x32.png",
        "icons/128x128.png",
        "icons/128x128@2x.png",
        "icons/icon.icns",
        "icons/icon.ico"
      ]
    }
  }
}

Edit on GitHub

Last updated on