dynamic_app_icon #

A Flutter plugin to dynamically change your app’s icon at runtime on iOS and Android.
Users just need to add icons to assets/icons/, run the generator script, and the plugin handles everything.

✨ Features #

• Change app icons programmatically
• Supports multiple icons
• Android alias setup automated
• iOS alternate icons handled automatically
• Generator script to create native entries (AndroidManifest + Info.plist)
• Example app included

📸 Video Demo #

Here’s how it works in action 👇

[Demo]

(Converted from assets/demo.mov — keep both in repo for reference)

🖼️ Screenshots #

[assets/1.png] [assets/2.png] [assets/3.png]

🚀 Getting Started #

1. Install the plugin #

dependencies:
  dynamic_app_icon: ^1.0.0

2. Add your icons #

Place your icons in:

assets/icons/
  ├─ icon1.png
  ├─ icon2.png
  ├─ icon3.png

And declare in pubspec.yaml:

flutter:
  assets:
    - assets/icons/

3. Run the generator #

dart run tool/generate_icons.dart

This script will:

• Update AndroidManifest.xml with <activity-alias>
• Update Info.plist with alternate icons
• Generate lib/generated_icons.dart and GeneratedIcons.kt

📱 Usage #

import 'package:dynamic_app_icon/dynamic_app_icon.dart';
import 'package:dynamic_app_icon/generated_icons.dart';

await DynamicAppIcon.setIcon("icon2"); // switch to icon2
await DynamicAppIcon.resetIcon(); // reset to default

print(GeneratedIcons.available); // list of available icons

📂 Example #

Check the example/ app for a working demo.

🛠️ Platform Support #

• ✅ Android
• ✅ iOS
• ❌ Web (not supported)

📜 License #

This project is licensed under the MIT License - see the LICENSE file for details.