OpenParable
Skip to content
← Back to skills

Hugeicons

Development
hugeicons

Hugeicons 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 — always grep for a keyword and copy the exact match:

grep -i search references/icon-list.md          # JS frameworks
grep -i home   references/icon-list-flutter.md   # Flutter

Do not rely on memory for icon names — a guessed name may not exist, or may exist but be the wrong glyph (e.g. LeftToRightBlockQuoteIcon is quote marks, not the bracket you wanted). Grep, confirm, copy.

1. Detect the framework

Check the project's manifest and match the installed package:

FrameworkDetect byComponent
React@hugeicons/react in package.jsonHugeiconsIcon
Vue@hugeicons/vue in package.jsonHugeiconsIcon
Svelte@hugeicons/svelte in package.jsonHugeiconsIcon
Angular@hugeicons/angular in package.jsonhugeicons-icon
React Native@hugeicons/react-native in package.jsonHugeiconsIcon
Flutterhugeicons in pubspec.yamlHugeIcon

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 hugeicons package bundles the icon data. Icons are HugeIcons.* constants of type List<List<dynamic>> (SVG path data, not Flutter IconData), rendered with HugeIcon — never Flutter's Icon.

3. Install & render (per framework)

Keep generated code minimal: icon is 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:

PropTypeDefaultDescription
iconIconSvgElementRequiredThe main icon to display (a named export from an icon package)
altIconIconSvgElement-Alternative icon for states, interactions, or dynamic swapping
showAltbooleanfalseWhen true, displays altIcon instead of icon
sizenumber | string24Icon size in pixels
colorstringcurrentColorIcon color (any CSS color value)
strokeWidthnumber1.5Width of the icon strokes
absoluteStrokeWidthbooleanfalseWhen true, stroke width is scaled relative to icon size
primaryColorstring-Primary color for multicolor Pro icons (Bulk, Duotone, Twotone)
secondaryColorstring-Secondary color for multicolor Pro icons
disableSecondaryOpacitybooleanfalseDisables default opacity applied to the secondary color
classNamestring-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:

PropTypeDefaultDescription
iconIconSvgObjectRequiredThe main icon to display (a named export from an icon package)
altIconIconSvgObject-Alternative icon for states, interactions, or animations
showAltbooleanfalseWhen true, displays altIcon instead of icon
sizenumber24Icon size in pixels
colorstringcurrentColorIcon color (any CSS color value)
strokeWidthnumber1.5Width of the icon strokes
classstring-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:

PropTypeDefaultDescription
iconIconSvgObjectRequiredThe main icon to display (a named export from an icon package)
altIconIconSvgObject-Alternative icon for states, interactions, or animations
showAltbooleanfalseWhen true, displays altIcon instead of icon
sizenumber24Icon size in pixels
colorstringcurrentColorIcon color (any CSS color value)
strokeWidthnumber1.5Width of the icon strokes
classstring-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:

PropTypeDefaultDescription
iconIconSvgObjectRequiredThe main icon to display (a named export from an icon package)
altIconIconSvgObject-Alternative icon for states, interactions, or animations
showAltbooleanfalseWhen true, displays altIcon instead of icon
sizenumber24Icon size in pixels
colorstringcurrentColorIcon color (any CSS color value)
strokeWidthnumber1.5Width of the icon strokes
classstring-Additional CSS classes

React Native

Install:

npm install @hugeicons/react-native @hugeicons/core-free-icons

Note: Color defaults to #000000 (not currentColor) 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:

PropTypeDefaultDescription
iconIconSvgObjectRequiredThe main icon to display (a named export from an icon package)
altIconIconSvgObject-Alternative icon for states, interactions, or animations
showAltbooleanfalseWhen true, displays altIcon instead of icon
sizenumber24Icon size in pixels
colorstring#000000Icon color (color string)
strokeWidthnumber1.5Width of the icon strokes

Flutter

Install:

flutter pub add hugeicons

Note: Flutter bundles the icon data directly: HugeIcons.* constants are List<List<dynamic>> SVG path data, not IconData. Render with HugeIcon, never Flutter's Icon.

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:

PropTypeDefaultDescription
iconList<List<dynamic>>RequiredThe icon data (a HugeIcons.* constant) — NOT a Flutter IconData
colorColorIconTheme colorIcon color; falls back to the ambient IconTheme
sizedouble24.0Icon size in logical pixels; falls back to IconTheme size
strokeWidthdouble-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 icon is 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 are List<List<dynamic>>. Render with HugeIcon, not Icon.