@hugeicons/core-free-icons 1.0.16 → 1.1.0

package/README.md

@@ -1,17 +1,18 @@
 # @hugeicons/core-free-icons
 
-> HugeIcons Core Free Icons Package - Beautiful and customizable icons for your applications
+> Hugeicons Core Free Icons Package - Beautiful and customizable icons for your applications
 
 ![31c9262e-aeea-4403-9086-3c8b88885cab](https://github.com/hugeicons/hugeicons-react/assets/130147052/ff91f2f0-095a-4c6d-8942-3af4759f9021)
 
-## What is HugeIcons?
+## What is Hugeicons?
 
-HugeIcons is a comprehensive icon library designed for modern web and mobile applications. The free package includes 4,000+ carefully crafted icons in the Stroke Rounded style, while the pro version offers over 36,000 icons across 9 unique styles.
+Hugeicons is a comprehensive icon library designed for modern web and mobile applications. The free package includes 4,500+ carefully crafted icons in the Stroke Rounded style, while the pro version offers over 40,000+ icons across 9 unique styles.
 
 ### Key Highlights
-- **4,000+ Free Icons**: Extensive collection of Stroke Rounded icons covering essential UI elements, actions, and concepts
+- **4,500+ Free Icons**: Extensive collection of Stroke Rounded icons covering essential UI elements, actions, and concepts
 - **Pixel Perfect**: Every icon is crafted on a 24x24 pixel grid ensuring crisp, clear display at any size
 - **Customizable**: Easily adjust colors, sizes, and styles to match your design needs
+- **Optimized Loading**: New individual icon imports reduce bundle size by 99%
 - **Regular Updates**: New icons added regularly to keep up with evolving design trends
 
 > 📚 **Looking for Pro Icons?** Check out our comprehensive documentation at [docs.hugeicons.com](https://docs.hugeicons.com) for detailed information about pro icons, styles, and advanced usage.
@@ -40,26 +41,59 @@ npm install @hugeicons/svelte        # for Svelte
 
 ## Usage
 
-This package provides the core icons. Here's how to import from the core package:
+### Import Methods
+
+This package now supports multiple import methods for maximum flexibility:
+
+#### 1. Static Import (Tree-shakeable)
+Best for production builds when you know which icons you need:
+
+```javascript
+import { Home01Icon, User01Icon } from '@hugeicons/core-free-icons';
+```
+
+#### 2. Dynamic Import - Full Bundle
+Loads the entire icon library (use when you need many icons dynamically):
 
 ```javascript
-// Import directly from core package
-import { HomeIcon } from '@hugeicons/core-free-icons';
+const { Home01Icon } = await import('@hugeicons/core-free-icons');
 ```
 
+#### 3. Dynamic Import - Individual Icons (NEW ✨)
+Loads only the specific icon you need (99% smaller bundle size):
+
+```javascript
+// Loads just ~0.75KB instead of ~5MB!
+const icon = await import('@hugeicons/core-free-icons/Home01Icon');
+const Home01Icon = icon.default;
+```
+
+### Performance Comparison
+
+| Import Method | Bundle Size | Load Time | Best For |
+|--------------|-------------|-----------|----------|
+| Static Import | ~2-3KB per icon | 0ms (bundled) | Production builds |
+| Dynamic Full Bundle | ~5MB | 100-200ms | Many dynamic icons |
+| Dynamic Individual | ~0.75KB | 10-20ms | Icon pickers, lazy loading |
+
 For real-world applications, we recommend using our framework-specific packages that provide optimized components and additional features. Check out the Framework Support section below for more details.
 
 ## Features
 
-- Modern, high-quality SVG icons
-- Tree-shakeable - only import what you use
-- TypeScript support
-- ESM and CommonJS support
-- Side-effect free
+- 🎯 **Individual Icon Imports**: Load only what you need with 99% bundle size reduction
+- 🌳 **Tree-shakeable**: Optimized for modern bundlers
+- 📦 **Multiple Import Methods**: Static, dynamic bundle, or dynamic individual
+- 🔷 **TypeScript Support**: Full type definitions included
+- 📱 **Framework Agnostic**: Works with any JavaScript framework
+- ⚡ **Optimized Performance**: Lazy load icons on demand
+- 🎨 **Customizable**: Easy to style with CSS or inline styles
+- ✅ **ESM & CommonJS**: Support for both module systems
+- 🚀 **Zero Dependencies**: No external dependencies
+- 🔄 **Regular Updates**: New icons added frequently
 
 ## Framework Support
 
-HugeIcons provides dedicated packages for various frameworks:
+Hugeicons provides dedicated packages for various frameworks:
 - [@hugeicons/react](https://www.npmjs.com/package/@hugeicons/react) - For React applications
 - [@hugeicons/react-native](https://www.npmjs.com/package/@hugeicons/react-native) - For React Native applications
 - [@hugeicons/vue](https://www.npmjs.com/package/@hugeicons/vue) - For Vue applications