Skip to content
pubscout

chameleon_icons

0.2.0, released 3 weeks ago by farookjamal.com

Dynamically change and reset app launcher icons at runtime on Android and iOS.

WASM-ready
$ flutter pub add chameleon_icons
Source repository

What it does

A cross-platform Flutter plugin and CLI tool that lets you switch app launcher icons at runtime on Android and iOS. It automatically resizes source images into required multi-density assets and injects necessary native configurations into AndroidManifest.xml and Info.plist.

AI-written summary of version 0.2.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You want to allow users to pick a custom app launcher icon from within your app settings.
  • You want an automated CLI tool to handle native asset resizing and configuration for app icons.

Skip it when

  • You only need a single static app icon (use flutter_launcher_icons instead).
  • You are targeting platforms other than Android and iOS.

Strengths

  • Automates native boilerplate generation for both Android and iOS.
  • Provides a strongly-typed generated definitions file and reactive ValueNotifier.
  • Supports zero-manual-setup workflows via a CLI generator.

Weaknesses

  • Requires native platform support (Android 7.0+ and iOS 15.0+).
  • Requires running a CLI generation step for asset processing and manifest injections.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
5

Requires adding a chameleon_icons block to pubspec.yaml and running the CLI generator dart run chameleon_icons:generate.

import 'package:flutter/material.dart';
import 'package:chameleon_icons/chameleon_icons.dart';

final chameleon = ChameleonIcons();

Future<void> switchIcon() async {
  final isSupported = await chameleon.isAlternateIconsSupported();
  if (isSupported) {
    await chameleon.changeIcon("MainActivityDark");
  }
}

Alternatives

Packages that do the same job and could replace chameleon_icons.

  • flutter_launcher_icons

    Pick this if you only need to generate static compile-time app launcher icons rather than switching them dynamically at runtime.

Works with

Packages commonly used together with chameleon_icons: ones it builds on, ones built on it, and its own family.