bee_dynamic_launcher
Dynamic launcher icons for Flutter: Android activity-alias switching and iOS alternate app icons, with a Dart API and optional CLI to sync native projects from a JSON catalog.
What this package is like to depend on
Last release 3 months ago
27 Apr 2026
Too new to tell
only 2 release windows
Nearly every release is documented
notes for 3 of 3 stable releases
Nothing withdrawn
no release was ever pulled
4 months old
3 releases · first in 2026
3 releases in the last 12 months
see the full history below
Release timeline
3 releases · Apr 2026 to Apr 2026Releases
latest 3-
1.1.027 Apr 2026Release notes
Open source →What's Changed
- Add optional per-variant branding style metadata in
catalog.json(baseColor,secondaryColor,backgroundColor,surfaceColor). - Add one-call style APIs:
applyVariantAndGetStyleandapplyVariantAndGetStyleColors. - Add ready-to-use color helpers:
LauncherVariantResolvedColors,styleColorsForVariant, andcurrentStyleColors. - Update example app to apply active style/colors from catalog with cleaner border-focused UI accents.
- Update README + API reference + CHANGELOG for the new styling capabilities.
Notes
- Native MethodChannel contract is unchanged; styling remains Dart-side metadata.
Full Changelog: v1.0.1...v1.1.0
Release notes
Open source →- Add optional per-variant branding style metadata in
catalog.json(baseColor,secondaryColor,backgroundColor,surfaceColor) with safe fallback behavior. - Add style helper APIs:
styleForVariant,currentStyleapplyVariantAndGetStyle(one-call apply + resolve style)
- Add ready-to-use Flutter color helpers:
LauncherVariantResolvedColorsstyleColorsForVariant,currentStyleColorsapplyVariantAndGetStyleColors(one-call apply + resolve colors)
- Update example app to demonstrate active variant styling and color usage with the new API.
- Add optional per-variant branding style metadata in
-
1.0.121 Apr 2026Release notes
Open source →What's Changed
- Fix Android launcher alias resolution when applicationId differs from manifest namespace (for example product flavors with applicationIdSuffix).
- Improve ComponentName lookup so alias classes are resolved from merged manifest activities.
Impact
- Dynamic launcher switching now works consistently for both single-flavor and multi-flavor Android apps.
Full Changelog: c03e23d...v1.0.1
Release notes
Open source →- Android: resolve activity-alias
ComponentNameusing the merged manifest namespace (Gradlenamespace) while keeping the install-time package ascontext.packageName. FixesapplicationIdSuffix/ product-flavor installs where aliases are registered asnamespace.Launcher…but the app id isnamespace.staging(or similar).
-
1.0.014 Apr 2026Release notes
Open source →bee_dynamic_launcheris now stable 🎉Switch Android and iOS launcher icons from Flutter using one JSON catalog and one CLI flow.
What you get
- Dynamic launcher icon switching on Android and iOS
- JSON-driven variant catalog (
catalog.json+ic_<id>.png) - In-app preview helpers via
LauncherCatalog - Native sync CLI via
dart run bee_dynamic_launcher
CLI highlights
- Validate catalog and icon consistency (
--scan,--scan --strict) - Check native setup without writes (
--check-android-manifest,--check-ios-pbxproj) - Generate native resources and icon outputs in one command
Docs
- Setup and platform guides: https://github.com/dedinopriadi/bee_dynamic_launcher#readme
- Package page: https://pub.dev/packages/bee_dynamic_launcher
Thanks to everyone who helped shape this initial stable release.
Release notes
Open source →- First stable release:
BeeDynamicLauncherMethodChannel API for Android and iOS. LauncherCatalogwith JSON loading, preview path getters (allPreviewIconAssetPaths,variantEntryFor,launcherLabelFor, and related helpers).BeeDynamicLauncher.previewIconAssetPathfor in-app preview assets.- CLI:
dart run bee_dynamic_launcher— validate assets, patch Android/iOS markers, resize icons; flags--icons-only,--native-only,--scan,--wizard, etc.