Menu
Table of Contents

Icons - v2.0

Icons Changelog

2.0.0 - 2025-10-06

🚨 MAJOR BREAKING CHANGES

This release represents a fundamental architectural transformation from a hardcoded icon provider to an extensibility layer for custom icon sets using blade-ui-kit/blade-icons.

Removed Classes and Methods

  • REMOVED: ArtisanPackUI\Icons\Icons class (17,282 lines)
    • getIcons() method
    • iconsList() method
  • REMOVED: ArtisanPackUI\Icons\Facades\Icons facade
  • REMOVED: All facades directory and classes

Removed Helper Functions

  • REMOVED: getIcons() global helper function
  • REMOVED: iconsLists() global helper function
  • REMOVED: icons() global helper function
  • REMOVED: helpers.php file completely

Removed Blade Directives

  • REMOVED: @apIcons Blade directive
  • REMOVED: All hardcoded icon rendering functionality

Removed Asset Serving

  • REMOVED: Asset serving routes (previously at /artisanpack-ui-icons/css)
  • REMOVED: dist/ directory with CSS and webfonts
  • REMOVED: Font Awesome bundled assets
  • REMOVED: package.json and Node.js build processes

Removed Icon Filtering

  • REMOVED: Icon filtering by category, type, or other attributes
  • REMOVED: All hardcoded icon data arrays

✨ New Features

Custom Icon Set Registration

  • NEW: Configuration-based icon set registration via config/artisanpack/icons.php
  • NEW: Event-driven icon set registration using ap.icons.register-icon-sets filter
  • NEW: IconSetRegistration class for structured icon set definitions
  • NEW: Hybrid registration system (config + events)

Modern Architecture

  • NEW: Integration with blade-ui-kit/blade-icons v1.8+
  • NEW: Blade component approach: <x-icon-prefix-name />
  • NEW: Support for multiple icon sets (Font Awesome Pro, Heroicons, custom)
  • NEW: Memory efficient - 95%+ reduction in memory usage

🔧 Configuration Changes

New Configuration File

php artisan vendor:publish --tag=artisanpack-package-config

Required Dependencies

  • ADDED: blade-ui-kit/blade-icons ^1.8
  • KEPT: tormjens/eventy ^0.9.4 (for event-driven extensibility)
  • REMOVED: ext-fileinfo dependency

📚 Migration Guide

⚠️ IMPORTANT: This release requires manual migration. See Migration Guide for detailed instructions.

Quick Migration Steps

  1. Update composer dependencies to ^2.0
  2. Publish new configuration: php artisan vendor:publish --tag=artisanpack-package-config
  3. Remove old code (see migration guide for details)
  4. Obtain and configure your icon sets (Font Awesome Pro recommended)
  5. Update templates to use new Blade components

Before/After Examples

Old v1.x:

@apIcons
<i class="ap-icon ap-icon-home"></i>

New v2.0:

<x-icon-fas-home class="w-6 h-6" />

🚨 Deprecation Notice

v1.x End of Life

  • v1.x Support: Continues until December 31, 2025
  • Security Updates: Critical security fixes only
  • Feature Development: All new features will be v2.0+ only

Migration Timeline

  • October 2025: v2.0.0 release
  • November 2025 - March 2026: Migration period with dual support
  • April 2026: v1.x marked as deprecated (warnings in composer)
  • January 2027: v1.x end of life

Support Resources

Getting Help

  • Documentation: Full migration guide with troubleshooting
  • Community: Discussion and questions via GitLab issues
  • Professional Support: Available for enterprise migrations

🎯 Benefits of v2.0

Performance Improvements

  • Memory Usage: 95%+ reduction (no more hardcoded icon arrays)
  • Loading Speed: Only load icons you actually use
  • Caching: Better browser caching with SVG components

Flexibility

  • Any Icon Set: Use Font Awesome Pro, Heroicons, custom icons
  • Multiple Sets: Mix different icon libraries in one project
  • Easy Updates: Update icon sets independently of package

Developer Experience

  • Better IDE Support: Blade components with autocompletion
  • Modern Approach: Aligned with Laravel/Blade best practices
  • Direct Control: Manage your own SVG files

1.0.4 - May 14, 2025

  • Fixed errors found while renaming the vendor.

1.0.3 - May 14, 2025

  • Corrected the version number in the composer.json file.

1.0.2 - May 14, 2025

  • Updated vendor name to ArtisanPack UI.

1.0.1 - May 14, 2025

  • Updated the version number for the tormjens/eventy package.

1.0.0 - April 30, 2025

  • Initial release