Hugeicons
DevelopmenthugeiconsHugeicons is an Agent Skill for development published in the hugeicons/hugeicons repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use and find Hugeicons icons in any framework — React, Vue, Svelte, Angular, React Native, and Flutter. Covers installation, rendering, props, icon naming, and the full icon catalog. Use whenever a project depends on @hugeicons/*, @hugeicons-pro/*, or the Flutter hugeicons package and you need to add, render, or pick an icon.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/hugeicons/hugeicons/blob/HEAD/skills/hugeicons/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/hugeicons, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Hugeicons
Hugeicons is an SVG icon library with one rendering package per framework plus a shared icon set. This skill covers all official packages. Work in three steps: detect the framework, render with its component, then pick icon names from the right catalog.
⚠️ Read this first: grep the icon lists, never read them whole
The reference files under
references/list thousands of icons and run tens of thousands of tokens each. Never open one in full — alwaysgrepfor a keyword and copy the exact match:grep -i search references/icon-list.md # JS frameworks grep -i home references/icon-list-flutter.md # FlutterDo not rely on memory for icon names — a guessed name may not exist, or may exist but be the wrong glyph (e.g.
LeftToRightBlockQuoteIconis quote marks, not the bracket you wanted). Grep, confirm, copy.
1. Detect the framework
Check the project's manifest and match the installed package:
| Framework | Detect by | Component |
|---|---|---|
| React | @hugeicons/react in package.json | HugeiconsIcon |
| Vue | @hugeicons/vue in package.json | HugeiconsIcon |
| Svelte | @hugeicons/svelte in package.json | HugeiconsIcon |
| Angular | @hugeicons/angular in package.json | hugeicons-icon |
| React Native | @hugeicons/react-native in package.json | HugeiconsIcon |
| Flutter | hugeicons in pubspec.yaml | HugeIcon |
If more than one matches (e.g. a monorepo), use the one for the file you are editing.
2. Two architectures
- JS frameworks (React, Vue, Svelte, Angular, React Native) — the
@hugeicons/*package is a renderer only. Icons are named exports imported from a separate package,@hugeicons/core-free-icons(free). The same icon names work across all five frameworks. - Flutter — the
hugeiconspackage bundles the icon data. Icons areHugeIcons.*constants of typeList<List<dynamic>>(SVG path data, not FlutterIconData), rendered withHugeIcon— never Flutter'sIcon.
3. Install & render (per framework)
Keep generated code minimal:
iconis the only required prop. Don't write props that just repeat the component's default value (e.g.size={24},color="currentColor",strokeWidth={1.5}) — pass a prop only when overriding a default. The defaults are listed in each props table below.
React
Install:
npm install @hugeicons/react @hugeicons/core-free-icons
Render:
import { HugeiconsIcon } from '@hugeicons/react';
import { Search01Icon } from '@hugeicons/core-free-icons';
function App() {
// Only `icon` is required; pass other props only to override a default.
return <HugeiconsIcon icon={Search01Icon} />;
}
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | IconSvgElement | Required | The main icon to display (a named export from an icon package) |
altIcon | IconSvgElement | - | Alternative icon for states, interactions, or dynamic swapping |
showAlt | boolean | false | When true, displays altIcon instead of icon |
size | number | string | 24 | Icon size in pixels |
color | string | currentColor | Icon color (any CSS color value) |
strokeWidth | number | 1.5 | Width of the icon strokes |
absoluteStrokeWidth | boolean | false | When true, stroke width is scaled relative to icon size |
primaryColor | string | - | Primary color for multicolor Pro icons (Bulk, Duotone, Twotone) |
secondaryColor | string | - | Secondary color for multicolor Pro icons |
disableSecondaryOpacity | boolean | false | Disables default opacity applied to the secondary color |
className | string | - | Additional CSS classes |
Vue
Install:
npm install @hugeicons/vue @hugeicons/core-free-icons
Render:
<script setup>
import { HugeiconsIcon } from '@hugeicons/vue'
import { Search01Icon } from '@hugeicons/core-free-icons'
</script>
<template>
<!-- Only :icon is required; pass other props only to override a default. -->
<HugeiconsIcon :icon="Search01Icon" />
</template>
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | IconSvgObject | Required | The main icon to display (a named export from an icon package) |
altIcon | IconSvgObject | - | Alternative icon for states, interactions, or animations |
showAlt | boolean | false | When true, displays altIcon instead of icon |
size | number | 24 | Icon size in pixels |
color | string | currentColor | Icon color (any CSS color value) |
strokeWidth | number | 1.5 | Width of the icon strokes |
class | string | - | Additional CSS classes |
Svelte
Install:
npm install @hugeicons/svelte @hugeicons/core-free-icons
Render:
<script>
import { HugeiconsIcon } from '@hugeicons/svelte'
import { Search01Icon } from '@hugeicons/core-free-icons'
</script>
<!-- Only icon is required; pass other props only to override a default. -->
<HugeiconsIcon icon={Search01Icon} />
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | IconSvgObject | Required | The main icon to display (a named export from an icon package) |
altIcon | IconSvgObject | - | Alternative icon for states, interactions, or animations |
showAlt | boolean | false | When true, displays altIcon instead of icon |
size | number | 24 | Icon size in pixels |
color | string | currentColor | Icon color (any CSS color value) |
strokeWidth | number | 1.5 | Width of the icon strokes |
class | string | - | Additional CSS classes |
Angular
Install:
npm install @hugeicons/angular @hugeicons/core-free-icons
Note: The component is
HugeiconsIconComponent, rendered via the<hugeicons-icon>selector. Import the icon in the component class and bind it with[icon].
Render:
// example.component.ts
import { Component } from '@angular/core'
import { HugeiconsIconComponent } from '@hugeicons/angular'
import { Search01Icon } from '@hugeicons/core-free-icons'
@Component({
selector: 'app-example',
standalone: true,
imports: [HugeiconsIconComponent],
// Only [icon] is required; bind other props only to override a default.
template: `<hugeicons-icon [icon]="searchIcon" />`,
})
export class ExampleComponent {
searchIcon = Search01Icon
}
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | IconSvgObject | Required | The main icon to display (a named export from an icon package) |
altIcon | IconSvgObject | - | Alternative icon for states, interactions, or animations |
showAlt | boolean | false | When true, displays altIcon instead of icon |
size | number | 24 | Icon size in pixels |
color | string | currentColor | Icon color (any CSS color value) |
strokeWidth | number | 1.5 | Width of the icon strokes |
class | string | - | Additional CSS classes |
React Native
Install:
npm install @hugeicons/react-native @hugeicons/core-free-icons
Note: Color defaults to
#000000(notcurrentColor) because React Native has no CSS color inheritance.
Render:
import { HugeiconsIcon } from '@hugeicons/react-native'
import { Search01Icon } from '@hugeicons/core-free-icons'
export default function App() {
// Only `icon` is required; pass other props only to override a default.
return <HugeiconsIcon icon={Search01Icon} />
}
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | IconSvgObject | Required | The main icon to display (a named export from an icon package) |
altIcon | IconSvgObject | - | Alternative icon for states, interactions, or animations |
showAlt | boolean | false | When true, displays altIcon instead of icon |
size | number | 24 | Icon size in pixels |
color | string | #000000 | Icon color (color string) |
strokeWidth | number | 1.5 | Width of the icon strokes |
Flutter
Install:
flutter pub add hugeicons
Note: Flutter bundles the icon data directly:
HugeIcons.*constants areList<List<dynamic>>SVG path data, notIconData. Render withHugeIcon, never Flutter'sIcon.
Render:
import 'package:hugeicons/hugeicons.dart';
// Only `icon` is required; color and size fall back to the ambient IconTheme.
// Pass color/size only to override those defaults.
HugeIcon(
icon: HugeIcons.strokeRoundedHome01,
color: Colors.black,
)
Props:
| Prop | Type | Default | Description |
|---|---|---|---|
icon | List<List<dynamic>> | Required | The icon data (a HugeIcons.* constant) — NOT a Flutter IconData |
color | Color | IconTheme color | Icon color; falls back to the ambient IconTheme |
size | double | 24.0 | Icon size in logical pixels; falls back to IconTheme size |
strokeWidth | double | - | Stroke thickness for stroke-style icons |
4. Find an icon
- React, Vue, Svelte, Angular, React Native — PascalCase named exports ending in
Icon(e.g.Search01Icon,Home01Icon,Notification03Icon). Number words are spelled out:1st-bracket→FirstBracketIcon,3d-view→ThreeDViewIcon. Import from@hugeicons/core-free-icons. Full list: references/icon-list.md (5,471 icons). - Flutter —
HugeIcons.strokeRounded<Name>constants (e.g.HugeIcons.strokeRoundedSearch01). Full list: references/icon-list-flutter.md (4,547 icons).
Grep these files — don't read them whole (see the warning at the top). Search for a term,
copy the exact matching name, and don't guess: many icons have numbered variants (01, 02,
03) — pick the one that best fits.
5. Free vs Pro icons
- Free (default):
@hugeicons/core-free-icons— 5,100+ stroke-rounded icons. Suggest only these unless the user has a Pro license. - Pro (license required, authenticated install):
@hugeicons-pro/core-stroke-rounded,@hugeicons-pro/core-stroke-sharp,@hugeicons-pro/core-stroke-standard,@hugeicons-pro/core-solid-rounded,@hugeicons-pro/core-solid-sharp,@hugeicons-pro/core-solid-standard,@hugeicons-pro/core-bulk-rounded,@hugeicons-pro/core-duotone-rounded,@hugeicons-pro/core-duotone-standard,@hugeicons-pro/core-twotone-rounded.
Never suggest a Pro-only icon to a free user — the import will fail.
Troubleshooting
- Icon not rendering: confirm
iconis a valid export/constant and not null. - JS import fails: the name is misspelled or Pro-only. Check the exact export in
references/icon-list.md. - Flutter type error expecting
IconData: wrong type — Hugeicons constants areList<List<dynamic>>. Render withHugeIcon, notIcon.