|
|
há 11 meses atrás | |
|---|---|---|
| .. | ||
| README.md | há 11 meses atrás | |
| package.json | há 11 meses atrás | |
Hugeicons Core Free Icons Package - Beautiful and customizable icons for your applications
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.
📚 Looking for Pro Icons? Check out our comprehensive documentation at docs.hugeicons.com for detailed information about pro icons, styles, and advanced usage.
This is a core package that provides the raw icons. To use these icons in your project, you'll need to install both this package and the corresponding framework-specific package:
# First, install the core package
npm install @hugeicons/core-free-icons
# Then install the framework-specific package
npm install @hugeicons/react # for React
# or
npm install @hugeicons/react-native # for React Native
# or
npm install @hugeicons/vue # for Vue
# or
npm install @hugeicons/angular # for Angular
# or
npm install @hugeicons/svelte # for Svelte
This package now supports multiple import methods for maximum flexibility:
Best for production builds when you know which icons you need:
import { Home01Icon, User01Icon } from '@hugeicons/core-free-icons';
Loads the entire icon library (use when you need many icons dynamically):
const { Home01Icon } = await import('@hugeicons/core-free-icons');
Loads only the specific icon you need (99% smaller bundle size):
// Loads just ~0.75KB instead of ~5MB!
const icon = await import('@hugeicons/core-free-icons/Home01Icon');
const Home01Icon = icon.default;
| 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.
This package is optimized for tree-shaking with modern bundlers (Webpack, Rollup, Vite, etc.). When you import icons using the standard syntax, bundlers will automatically eliminate unused icons:
// Only the icons you import will be included in your bundle
import { UserIcon, HomeIcon } from '@hugeicons/core-free-icons';
// Bundlers automatically tree-shake unused icons
// Result: Only UserIcon and HomeIcon (~1.5KB) instead of entire library (~5MB)
Requirements for tree-shaking:
sideEffects: false for optimal tree-shakingHugeicons provides dedicated packages for various frameworks:
Each framework package provides optimized components, additional features, and framework-specific documentation.
TypeScript types are included and will work out of the box.
Created by Hugeicons. All rights reserved.