Ensemble Icons #

A comprehensive Flutter icon package providing access to multiple icon libraries including Material Design, Remix Icons, and Font Awesome. Perfect for Flutter applications that need consistent, high-quality icons across different design systems.

✨ Features #

• Multiple Icon Libraries: Material Design, Remix Icons, and Font Awesome
• Easy Integration: Simple API for using icons in your Flutter apps
• Customizable: Support for custom sizing, colors, and styling
• High Quality: Vector-based icons that scale perfectly
• Ensemble UI Ready: Designed to work seamlessly with Ensemble UI framework

🚀 Quick Start #

Installation #

Add this to your pubspec.yaml:

dependencies:
  ensemble_icons: ^1.0.2

Then run:

flutter pub get

Basic Usage #

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

// Icons are looked up by name from static iconMap tables
Icon(MaterialIcons.iconMap['home']!, size: 24.0, color: Colors.blue);
Icon(Remix.iconMap['home_line']!, size: 24.0, color: Colors.green);
Icon(FontAwesome.iconMap['house']!, size: 24.0, color: Colors.orange);

🎨 Icon Libraries #

Material Design Icons #

• Version: Latest Flutter SDK version
• Features: Google's Material Design icon set
• Usage: MaterialIcons.iconMap['icon_name']

Remix Icons #

• Version: v4.2.0 (2024-03-13)
• Features: Open-source icon library with 2,000+ icons
• Usage: Remix.iconMap['icon_name'] (class Remix in remixicon.dart)

Font Awesome Icons #

• Version: v6.5.1 (2024-03-11)
• Features: Professional icon toolkit with 1,600+ free icons
• Usage: FontAwesome.iconMap['icon_name'] (class FontAwesome in fontAwesomeIcon.dart)

🔧 Advanced Usage #

Custom Icon Widget #

class CustomIcon extends StatelessWidget {
  final String iconName;
  final String library;
  final double size;
  final Color? color;

  const CustomIcon({
    super.key,
    required this.iconName,
    this.library = 'default',
    this.size = 24.0,
    this.color,
  });

  @override
  Widget build(BuildContext context) {
    final IconData? iconData = switch (library) {
      'remix' => Remix.iconMap[iconName],
      'fontAwesome' => FontAwesome.iconMap[iconName],
      _ => MaterialIcons.iconMap[iconName],
    };
    if (iconData == null) return const SizedBox.shrink();
    return Icon(iconData, size: size, color: color);
  }
}

Ensemble UI Integration #

- Icon:
    name: "home"
    library: "remix"  # default / remix / fontAwesome
    size: "24"
    color: "#007AFF"

📚 API Reference #

Icon Classes #

Common Properties #

🔄 Updating Icon Libraries #

Remix Icons #

Follow the documentation in the update folder to update to the latest version.

Font Awesome #

Update the font_awesome_flutter dependency in pubspec.yaml to get the latest icons.

Material Icons #

Material icons are automatically updated with Flutter SDK updates.

📱 Platform Support #

• ✅ Android: Full support
• ✅ iOS: Full support
• ✅ Web: Full support
• ✅ Desktop: Full support

🤝 Contributing #

We welcome contributions! Please feel free to:

• Report bugs and issues
• Suggest new features
• Submit pull requests
• Improve documentation

📄 License #

This project is licensed under the MIT License.

🙏 Acknowledgments #

• Part of the Ensemble UI ecosystem
• Built for the Flutter community

Built with ❤️ for the Flutter community