flutter-dynamic-icons-android

Configure Flutter Android dynamic icons with alias-only manifest patterns.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/MHD-Nour-KJ/Intertwined --skill flutter-dynamic-icons-android
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flutter-dynamic-icons-android
Source: https://github.com/MHD-Nour-KJ/Intertwined/tree/main/.gemini/skills/flutter-dynamic-icons-android
Command: npx skills add https://github.com/MHD-Nour-KJ/Intertwined --skill flutter-dynamic-icons-android

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves common failures with dynamic app icon switching in Flutter Android apps, including Samsung One UI launcher caching that ignores icon aliases, adaptive icon XML overrides that prevent visual icon changes, and persistence race conditions that cause icon settings to fail to save after app restart.

Core Features & Use Cases

  • Alias-Only Manifest Pattern: Eliminates duplicate launcher icons and Samsung caching issues by removing launcher intent filters from the main activity and using dedicated activity aliases for each icon variant.
  • Adaptive Icon Resource Fix: Resolves silent visual icon non-change issues by identifying and removing overriding XML files in mipmap-anydpi-v26 directories that mask unique icon assets.
  • Cross-Platform Implementation Guidance: Includes proven code snippets for native Kotlin component enabling logic and Dart-side persistence ordering and graceful app exit to ensure consistent behavior across all Android OEMs. Use cases include Flutter developers building apps that require dynamic icon switching for features like dark mode toggles, seasonal branding, or user-customizable app icons that work reliably on Samsung devices and modern Android versions.

Quick Start

Use this skill to implement working dynamic app icon switching for your Flutter Android app that functions correctly across all Android OEMs including Samsung One UI and modern API level 26+ devices.

Frequently Asked Questions about flutter-dynamic-icons-android

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does dynamic app icon switching fail on Samsung One UI in Flutter?

Dynamic app icon switching fails on Samsung One UI due to launcher caching that ignores activity aliases. You must remove the launcher intent filter from the main activity and use dedicated activity aliases for each icon variant to fix it.

How do I fix Flutter dynamic icons not updating visually on Android API 26+?

To fix dynamic icons not updating visually on Android API 26+, you must identify and remove overriding XML files in mipmap-anydpi-v26 directories that mask unique icon assets and prevent adaptive icon visual changes.

How do I implement activity aliases for dynamic app icons in Flutter Android?

Implement dynamic app icons by configuring the AndroidManifest with an alias-only pattern, using native Kotlin to manage component enabling logic, and handling Dart-side persistence ordering and graceful app exits.

What causes dynamic icon settings to reset after restarting a Flutter app?

Dynamic icon settings reset after restarting a Flutter app due to persistence race conditions. You must apply correct Dart-side persistence ordering before triggering a graceful app exit to ensure the icon setting saves successfully.

Does this dynamic app icon switching pattern work across all Android OEMs?

Yes, this implementation pattern ensures consistent dynamic app icon switching behavior across all Android OEMs, specifically targeting Samsung One UI and modern API level 26+ devices for reliable production app functionality.