App Icon

The generated project ships with the Kasy icon at assets/branding/app-icon.png. To swap it for your app's brand, use the CLI: it copies the image and generates every size automatically.

Implementation

1. Prepare the image:

   • Size: 1024 × 1024 px (or larger, square)
   • Square corners: send the PNG square, without rounding it. iOS and Android apply their own clipping mask when displaying. If you round it yourself, the corner gets cut twice.
   • Format: PNG
   • Background: solid is preferred (no transparency; the App Store doesn't accept alpha)

2. Run:

   kasy icon --image path/to/your-icon.png

   The command copies the image to assets/branding/app-icon.png, runs dart run flutter_launcher_icons, and generates iOS (ios/Runner/Assets.xcassets/AppIcon.appiconset/), Android (android/app/src/main/res/mipmap-*/), and web icons. You never need to touch those native folders manually.

   Manual alternative:

   1. Replace assets/branding/app-icon.png
   2. dart run flutter_launcher_icons
   3. Uninstall and reinstall the app on the device (iOS/Android cache the icon)

3. Verify:

   kasy run --ios
   kasy run --android

Information

Changing the favicon (web/PWA)

kasy favicon --image path/to/your-favicon.png

Updates assets/branding/favicon.png and regenerates web/favicon.png + PWA icons. Details in Favicon.

Last updated on 08/02/2026