Installation
Usage
All Gaia UI components use Hugeicons through this wrapper.Features
Consistent API
All icons use the same component:Size Control
Stroke Width
Adjust the icon weight:Custom Styling
Upgrading to Pro
To access 30,000+ premium icons:- Purchase Hugeicons Pro
- Install the Pro package:
- Update the icons wrapper:
- Restart your dev server
Commonly Used Icons
Here are icons frequently used in Gaia UI:Navigation
Actions
Media
UI Elements
Communication
Icon Naming Convention
Hugeicons follow a consistent naming pattern:- Base name: Describes the icon (e.g.,
Arrow,Search,File) - Variant number: Multiple versions of similar icons (e.g.,
01,02,03) - Suffix:
Iconat the end
Search01Icon,Search02IconArrow01Icon,Arrow02IconHome01Icon,Home02Icon
Finding Icons
To find available icons:- Browse the collection: Visit hugeicons.com
- Search in your IDE: Type
Iconand use autocomplete - Check the docs: See the full list in
@hugeicons/core-free-icons
Props
Best Practices
Size Guidelines
- 16px: Inline text icons, compact UIs
- 20px: Buttons, form inputs, navigation
- 24px: Main UI elements, cards, lists
- 32px+: Hero sections, empty states, large CTAs
Color Usage
Icons inherit text color by default:Accessibility
Add labels for standalone icons:Performance
The icons wrapper enables tree-shaking:- Only imported icons are bundled
- No impact on bundle size for unused icons
- Minimal runtime overhead