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 👇

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

---

🖼️ Screenshots

---

🚀 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.