New Features & Bug Fixes

New AI-Enhanced Icons ✨

Added 6 new AI-themed icons across all styles (Outlined, Filled, Broken, Bulk, TwoTone):

• brushAi - AI-powered brush/painting tool
• cameraAi - AI camera features
• emailAi - AI email assistance
• galleryAi - AI gallery/image management
• microphoneAi - AI voice/audio features
• penAi - AI writing assistant
• searchAi - AI-powered search

Bug Fixes 🔧

• Icon Naming Corrections: Fixed numerous typos in icon names across all styles

  Outlined/Filled/Broken Icons:

  • brifecaseCross → briefcaseCross
  • brifecaseTick → briefcaseTick
  • brifecaseTimer → briefcaseTimer
  • buliding → building2
  • trushSquare → trashSquare
  • userCirceAdd → userCircleAdd
  • voiceCricle → voiceCircle
  • bootsrap → bootstrap

  Bulk Icons (Background/Foreground):

  • brifecaseCrossBg/Fg → briefcaseCrossBg/Fg
  • brifecaseTickBg/Fg → briefcaseTickBg/Fg
  • brifecaseTimerBg/Fg → briefcaseTimerBg/Fg
  • bulidingBg/Fg → building2Bg/Fg
  • trushSquareBg/Fg → trashSquareBg/Fg
  • userCirlceAddBg/Fg → userCircleAddBg/Fg
  • voiceCricleBg/Fg → voiceCircleBg/Fg
  • bootsrapBg/Fg → bootstrapBg/Fg

  Payment Icons:

  • etherium → ethereum
  • Lightcoin → litecoin

  Note: These are breaking changes if you were using the misspelled names. Please update your code to use the corrected icon names.

• Icon Search: Improved search functionality on the package website to include new AI icons and handle corrected icon names

• Update README & add Icon License Attribution file

Package Size Optimization & Code Quality*

Breaking Changes

• Country Flags Removed: All country flag icons have been completely removed from the package

  • Significantly reduces package size for users who don't need country flags
  • Migration: Use the dedicated country_flags package or similar alternatives
  • See migration guide below for replacement code

• Payment Icons: File naming standardized to camelCase

  • Renamed: alipay → aliPay, bancontact → banContact, bitpay → bitPay
  • Renamed: mastercard → masterCard, paysafe → paySafe, webmoney → webMoney
  • No API changes required (methods already used camelCase)

• Other Icons: File naming standardized to camelCase

New Features

• Optimized Selective Imports: Import only the icon styles you need to reduce compiled code size

  import 'package:amazing_icons/outlined.dart';  // Only outlined icons
  import 'package:amazing_icons/filled.dart';    // Only filled icons
  import 'package:amazing_icons/broken.dart';    // Only broken icons
  import 'package:amazing_icons/bulk.dart';      // Only bulk icons
  import 'package:amazing_icons/twotone.dart';   // Only twotone icons
  import 'package:amazing_icons/payment.dart';   // Only payment icons

• Comprehensive API Documentation: All public methods now include detailed documentation

Package Optimization

• Removed unnecessary generator and tooling files from published package
• Removed demo assets (screenshots, GIFs) to reduce package size
• Cleaned up font generation artifacts (.json files)
• Optimized code structure and imports

Migration Guide from v2.0.0

Country Flags (Removed):

// Old (v2.x)
AmazingIconCountry.fromCountryCode(countryCode: 'fr', size: 25, shape: IconShape.rounded)

// New (v3.0) - Use dedicated package instead
// Add to pubspec.yaml: country_flags: ^3.0.0
import 'package:country_flags/country_flags.dart';
CountryFlag.fromCountryCode('FR', height: 25, width: 35, shape: BoxShape.rectangle, borderRadius: 8)

Optimized Imports (Recommended):

// Instead of importing everything
import 'package:amazing_icons/amazing_icons.dart';  // Still works but less optimal

// Import only what you need for better tree-shaking
import 'package:amazing_icons/outlined.dart';
import 'package:amazing_icons/bulk.dart';

Amazing Icons 2.0.0 - Performance Revolution 🚀

We're excited to announce Amazing Icons 2.0.0, a major release focused on performance optimization and modern rendering techniques!

🎯 What's New

⚡ 10x Performance Boost for Bulk & TwoTone Icons

Bulk and TwoTone icons now use icon fonts instead of SVG, delivering:

• 10x faster rendering - instant display with no parsing overhead
• Lower memory usage - native icon rendering by Flutter
• Smaller app size - compact font files instead of thousands of SVG assets
• Smooth animations - no lag when displaying multiple icons

🎨 New Customizable Opacity Control

Fine-tune the depth effect of Bulk and TwoTone icons:

// Subtle effect
AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.2)

// Default effect
AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.4)

// Strong effect
AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.6)

🏳️ Enhanced Country Flags with Shape Options

Country flags now support 3 shape styles:

// Circular flags
AmazingIconCountry.fromCountryCode(countryCode: "fr", size: 30, shape: IconShape.circle)

// Rounded corners (default)
AmazingIconCountry.fromCountryCode(countryCode: "us", size: 30, shape: IconShape.rounded)

// Sharp corners
AmazingIconCountry.fromCountryCode(countryCode: "jp", size: 30, shape: IconShape.sharp)

💳 Optimized Payment Icons

Payment icons migrated to jovial_svg with .si format for:

• Faster loading times
• Reduced memory footprint
• Better web compatibility

🔄 Breaking Changes

This is a major version with API changes. Please review the migration guide below.

API Changes Summary

Detailed Breaking Changes

1. Bulk & TwoTone Icons (Icon Fonts)

Before (v1.x):

SvgBulk.home(size: 24, color: Colors.blue)
SvgTwoTone.heart(size: 24, color: Colors.red)

After (v2.0):

AmazingIconBulk.home(size: 24, color: Colors.blue, opacity: 0.4)
AmazingIconTwotone.heart(size: 24, color: Colors.red, opacity: 0.4)

Changes:

• ✅ Returns Widget instead of SvgIcon
• ✅ New opacity parameter (default: 0.4)
• ✅ Uses dual IconData stack for rendering
• ✅ No longer requires flutter_svg

2. Country Flags (Jovial SVG)

Before (v1.x):

SvgCountry.fromCountryCode("fr", size: 25, shape: IconShape.rounded)

After (v2.0):

AmazingIconCountry.fromCountryCode(
  countryCode: "fr",
  size: 25,
  shape: IconShape.rounded
)

Changes:

• ✅ Named parameters required
• ✅ Uses .si format for compact storage
• ✅ Powered by jovial_svg for better performance

3. Payment Icons (Jovial SVG)

Before (v1.x):

SvgPayment.visa(size: 50)

After (v2.0):

AmazingIconPayment.visa(size: 50)

Changes:

• ✅ Class renamed
• ✅ Uses .si format for compact storage
• ✅ Powered by jovial_svg for better performance

4. Package Structure

All icon classes moved to lib/src/ directory.

Recommended import:

import 'package:amazing_icons/amazing_icons.dart';

📦 Dependencies

• Added: jovial_svg: ^1.1.24 - High-performance SVG rendering for Country and Payment icons
• Removed: flutter_svg: ^2.0.10+1 - No longer needed for Bulk and TwoTone icons

🚀 Migration Guide

Step 1: Update pubspec.yaml

dependencies:
  amazing_icons: ^2.0.0

Run:

flutter pub upgrade

Step 2: Update Bulk Icons

Find & Replace:

# Old pattern
SvgBulk.iconName(size: X, color: Y)

# New pattern
AmazingIconBulk.iconName(size: X, color: Y, opacity: 0.4)

Step 3: Update TwoTone Icons

Find & Replace:

# Old pattern
SvgTwoTone.iconName(size: X, color: Y)

# New pattern
AmazingIconTwotone.iconName(size: X, color: Y, opacity: 0.4)

Step 4: Update Country Flags

Find & Replace:

# Old pattern
SvgCountry.fromCountryCode("XX", size: Y)

# New pattern
AmazingIconCountry.fromCountryCode(countryCode: "XX", size: Y)

Step 5: Update Payment Icons

Find & Replace:

# Old pattern
SvgPayment.iconName(size: X)

# New pattern
AmazingIconPayment.iconName(size: X)

Step 6: Clean & Rebuild

flutter clean
flutter pub get
flutter run

📊 Performance Comparison

🐛 Bug Fixes

• Fixed clip-path issues in some SVG country flags
• Improved web compatibility for all icon types
• Better rendering on low-end devices

📚 Documentation

• Added comprehensive API documentation to all icon classes
• Updated README with new examples
• Enhanced code comments for better IntelliSense support

🙏 Thank You

Thank you to all contributors and users who provided feedback to make this release possible!

🔗 Resources

• Repository: https://github.com/O-Nicks/amazing_icons
• Pub.dev: https://pub.dev/packages/amazing_icons
• Issues: https://github.com/O-Nicks/amazing_icons/issues

Full Changelog: https://github.com/O-Nicks/amazing_icons/blob/master/CHANGELOG.md

Full Changelog: 1.2.0...1.2.1

What's Changed

• Refactor/country flags by @O-Nicks in #1

New Contributors

• @O-Nicks made their first contribution in #1

Full Changelog: 1.1.2...1.2.0

Full Changelog: 1.1.1...1.1.2

Full Changelog: 1.1.0...1.1.1

• 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<IconData>
  • AmazingIconFilled.all() - Returns List<IconData>
  • AmazingIconBroken.all() - Returns List<IconData>
  • SvgBulk.all(size, color) - Returns List<SvgIcon>
  • SvgTwoTone.all(size, color) - Returns List<SvgIcon>
  • SvgCountry.all(size) - Returns List<SvgIcon>
  • SvgPayment.all(size) - Returns List<SvgIcon>

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