icon_animated #

Small outline icons. Smooth transitions. Native Flutter behavior.

Quick start · Configuration · Example · Migration · Changelog

At a glance #

• 14 built-in outline icons with forward and reverse animations.
• Uses the space allocated by the parent, including narrow layouts.
• Reuses path geometry between animation frames.
• Inherits IconTheme and supports semantic labels and reduced motion.

Quick start #

Requirements: Flutter 3.32+ · Dart 3.8+

flutter pub add icon_animated

To use this major version explicitly:

dependencies:
  icon_animated: ^2.0.0

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

IconAnimated(
  active: isSaved,
  size: 48,
  iconType: IconType.check,
  semanticLabel: 'Saved',
)

Here, isSaved is a boolean from your application state.

Configuration #

Icon catalog #

Change active using setState or your preferred state management. The widget owns and disposes its animation controller.

Package structure #

lib/
├── icon_animated.dart           # Public exports
└── src/
    ├── icon_animated.dart       # Widget and private lifecycle state
    ├── icon_type.dart           # Icon enumeration
    ├── paths/                  # Icon geometry grouped by purpose
    └── rendering/              # Cached metrics and paint delegate

Import the package entry point. Files under src/ are implementation details and are not a supported import surface.

Development #

flutter pub get
dart format --output=none --set-exit-if-changed lib example test
flutter analyze --fatal-infos
flutter test
flutter pub publish --dry-run

CI validates Flutter 3.32.0 and the latest stable channel. When switching SDK versions locally, run flutter clean before testing to avoid reusing incompatible compiled shader assets.

Upgrading from 1.x #

Version 2.0 includes intentional API changes. Follow MIGRATION.md before changing an existing application's dependency constraint.

Support and license #

Report reproducible issues in GitHub Issues. Include the Flutter version and a minimal example.

Released under the MIT license.