amazing_icons 2.0.0

amazing_icons: ^2.0.0 copied to clipboard

Major Release - Performance Optimization and API Changes

Breaking Changes #

• Bulk & TwoTone Icons: Now use icon fonts instead of SVG for dramatic performance improvements

  • Changed from SvgIcon to Widget return type
  • Now use dual IconData stack (background + foreground with opacity)
  • API change: AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.4)
  • New opacity parameter (default: 0.4) to control the opacity effect
  • No longer require flutter_svg for these icon styles

• Country Flags: Migrated from flutter_svg to jovial_svg for better performance

  • Changed from SvgCountry to AmazingIconCountry
  • API change: AmazingIconCountry.fromCountryCode(countryCode: 'fr', size: 25, shape: IconShape.rounded)
  • New shape parameter: IconShape.circle, IconShape.rounded, IconShape.sharp
  • Uses compact .si format for faster loading

• Payment Icons: Migrated from flutter_svg to jovial_svg for better performance

  • Changed from SvgPayment to AmazingIconPayment
  • API change: AmazingIconPayment.visa(size: 50)
  • Uses compact .si format for faster loading

• Package Structure: All icon classes moved to lib/src/ directory

  • Import from main package: import 'package:amazing_icons/amazing_icons.dart';
  • Individual imports still available if needed

Performance Improvements #

• 10x faster rendering for Bulk and TwoTone icons by using icon fonts instead of SVG
• Reduced package size with optimized .si format for Country and Payment icons
• Instant loading for all icon fonts with no asset parsing required
• Lower memory usage with native icon rendering

New Features #

• Added opacity parameter to Bulk and TwoTone icons for customizable depth effects
• Added shape parameter to Country flags (circle, rounded, sharp)
• New jovial_svg dependency for high-performance SVG rendering

Dependencies #

• Added: jovial_svg: ^1.1.24 for Country and Payment icons
• removed: flutter_svg: ^2.0.10+1 (no longer needed for Bulk and TwoTone icons)

Migration Guide #

Bulk Icons:

// Old (v1.x)
SvgBulk.home(size: 24, color: Colors.blue)

// New (v2.0)
AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.4)

TwoTone Icons:

// Old (v1.x)
SvgTwoTone.heart(size: 24, color: Colors.red)

// New (v2.0)
AmazingIconTwotone.heart(size: 24, color: Colors.red, opacity: 0.4)

Country Flags:

// Old (v1.x)
SvgCountry.fromCountryCode("fr", size: 25, shape: IconShape.rounded)

// New (v2.0)
AmazingIconCountry.fromCountryCode(countryCode: "fr", size: 25, shape: IconShape.rounded)

Payment Icons:

// Old (v1.x)
SvgPayment.visa(size: 50)

// New (v2.0)
AmazingIconPayment.visa(size: 50)

• Add Web site link to README

• Update Country Flags to include new countries and territories
• Add Possibility to customize country flags (size, border, shape)
• Update Tests for new flags
• Update README with new flags information

• Update README

• Update README

• Fixed minor issues in documentation
• Improved code comments for better clarity
• Updated example app to showcase all icon styles and categories
• Update README with complete usage instructions

Initial Release - October 2025

Features #

• 🎨 3 Icon Font Styles with 997 icons each:

  • Outlined style icons
  • Filled style icons
  • Broken style icons

• 🔄 2 SVG Styles with Opacity Effects:

  • Bulk icons (997 icons) with opacity-based depth effect
  • TwoTone icons (991 icons) with two-tone opacity styling
  • Full color customization support
  • Maintains opacity effects when colored

• 🏳️ 201 Country Flags:

  • Full-color vector flags
  • All countries and territories
  • High-quality SVG rendering

• 💳 39 Payment Icons:

  • Popular payment brands (Visa, Mastercard, PayPal, etc.)
  • Cryptocurrency logos (Bitcoin, Ethereum, etc.)
  • Original brand colors preserved

API #

• Type-safe icon accessors with autocomplete support
• .all() method for each icon category:
  • AmazingIconOutlined.all() - Returns List
  • AmazingIconFilled.all() - Returns List
  • AmazingIconBroken.all() - Returns List
  • SvgBulk.all(size, color) - Returns List
  • SvgTwoTone.all(size, color) - Returns List
  • SvgCountry.all(size) - Returns List
  • SvgPayment.all(size) - Returns List

Performance #

• Icon fonts render instantly with no loading time
• SVG icons loaded on-demand with automatic caching
• Optimized asset loading

Documentation #

• Complete README with examples
• Example app demonstrating all icon styles
• Code documentation for all public APIs

Total Icons: 3,228 #

• Icon Fonts: 2,991 (997 × 3 styles)
• SVG with opacity: 1,988 (997 bulk + 991 twotone)
• Country flags: 201
• Payment icons: 39