01 · Fundamentos

Icon

tone neutral/accent/success/warning/error/info

Conjunto de ícones do kit: Hugeicons Stroke Rounded, traço 1,5 px, herdando a cor do texto.

Ícones com movimento

.heex
<div class="flex flex-wrap items-center gap-2.5"><.icon name="refresh" size="lg" class="animate-[lu-spin_1.2s_linear_infinite]" /><.icon name="bell" size="lg" class="origin-top animate-[mo-wiggle_5s_ease-in-out_infinite]" /><.icon name="sparkles" size="lg" class="animate-[mo-pulse_2s_ease-in-out_infinite] text-neg" /><.icon name="sparkles" size="lg" class="animate-[mo-float_4s_ease-in-out_infinite] text-accent-600" /></div>

tone

.heex
<div class="flex flex-wrap items-center gap-2.5"><.icon name="check-circle" size="md" boxed /><.icon name="check-circle" size="md" boxed tone="acc" /><.icon name="check-circle" size="md" boxed tone="pos" /><.icon name="check-circle" size="md" boxed tone="neg" /><.icon name="check-circle" size="md" boxed tone="warn" /><.icon name="check-circle" size="md" boxed tone="info" /></div>

Biblioteca do kit (72 mais usados)

.heex
<div class="flex flex-wrap items-center gap-1.5"><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="home"><.icon name="home" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="search"><.icon name="search" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="inbox"><.icon name="inbox" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="grid"><.icon name="grid" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="trend-up"><.icon name="trend-up" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="users"><.icon name="users" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="layers"><.icon name="layers" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="table"><.icon name="table" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="user-minus"><.icon name="user-minus" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="file"><.icon name="file" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="folder"><.icon name="folder" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="settings"><.icon name="settings" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="help"><.icon name="help" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bell"><.icon name="bell" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="moon"><.icon name="moon" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="sun"><.icon name="sun" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="calendar"><.icon name="calendar" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="compare"><.icon name="compare" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="filter"><.icon name="filter" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="download"><.icon name="download" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="upload"><.icon name="upload" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="arrow-up-right"><.icon name="arrow-up-right" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="arrow-right"><.icon name="arrow-right" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="chevron-down"><.icon name="chevron-down" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="plus"><.icon name="plus" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="x"><.icon name="x" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="check"><.icon name="check" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="more-h"><.icon name="more-h" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="sparkles"><.icon name="sparkles" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="ai"><.icon name="ai" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="message"><.icon name="message" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="chat"><.icon name="chat" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="mail"><.icon name="mail" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="lock"><.icon name="lock" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="eye"><.icon name="eye" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="copy"><.icon name="copy" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="trash"><.icon name="trash" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="edit"><.icon name="edit" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="star"><.icon name="star" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="clock"><.icon name="clock" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="send"><.icon name="send" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="attach"><.icon name="attach" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="mic"><.icon name="mic" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="info"><.icon name="info" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="alert"><.icon name="alert" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="check-circle"><.icon name="check-circle" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="link"><.icon name="link" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="refresh"><.icon name="refresh" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="kanban"><.icon name="kanban" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="list"><.icon name="list" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="image"><.icon name="image" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="package"><.icon name="package" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="wallet"><.icon name="wallet" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bank"><.icon name="bank" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="invoice"><.icon name="invoice" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="shield"><.icon name="shield" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="code"><.icon name="code" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="terminal"><.icon name="terminal" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bot"><.icon name="bot" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="palette"><.icon name="palette" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="card"><.icon name="card" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="building"><.icon name="building" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="tag"><.icon name="tag" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="cart"><.icon name="cart" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="timer"><.icon name="timer" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="target"><.icon name="target" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="dollar"><.icon name="dollar" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="rocket"><.icon name="rocket" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="flow"><.icon name="flow" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="brain"><.icon name="brain" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="key"><.icon name="key" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="server"><.icon name="server" /></span></div>

Tamanhos

.heex
<div class="flex flex-wrap items-center gap-2.5"><.icon name="package" size="sm" /><.icon name="package" size="md" /><.icon name="package" /><.icon name="package" size="lg" /><.icon name="package" size="xl" /></div>

Em caixa por estado

.heex
<div class="flex flex-wrap items-center gap-2.5"><.icon name="sparkles" boxed tone="acc" /><.icon name="check" boxed tone="pos" /><.icon name="x-circle" boxed tone="neg" /><.icon name="alert" boxed tone="warn" /><.icon name="info" boxed tone="info" /><.icon name="ai" boxed tone="lime" /><.icon name="file" boxed /></div>

Uso

<.icon name="hugeicons:analytics-up" class="size-[18px]" />
<!-- HTML puro --> <i data-i="trend-up"></i> + LedgerUI.hydrate()

Regras

  • Fonte oficial: hugeicons.com/icons/stroke-rounded (pacote @hugeicons/core-free-icons).
  • Tamanho padrão 18px em navegação, 16px dentro de botões, 14px em badges.
  • Ícones herdam currentColor; ícone decorativo fica aria-hidden, botão só-ícone recebe aria-label.
  • Em caixa (.lu-ic) o fundo segue o estado: acc, pos, neg, warn, info, lime.

Referência da API

Todos os function components, atributos, valores e slots que este componente cobre.

Server-side SVG icons (Hugeicons Stroke Rounded), no JavaScript needed.

<.icon name="download" />
<.icon name="huge-download-01" size="sm" class="text-muted" />
<.icon name="check-circle" boxed tone="success" />

The SVG is styled only with Tailwind utilities (stroke follows currentColor, so text-* colours it). size picks the box: sm 14px, md 16px, base 18px (default), lg 22px, xl 28px. Use size, not a size-* class, to change it: two utilities of one property in a class list are resolved by the stylesheet, not by their order.

<svg class="... size-[18px]" viewBox="0 0 24 24" aria-hidden="true" data-icon="download">...</svg>

Every icon is precomputed at compile time from priv/icons.json (regenerate it with elixir scripts/extract_icons.exs) as an iodata binary and emitted with Phoenix.HTML.raw/1, so rendering costs one map lookup.

Names

Dictionary keys (download, chevron-down, ...) are used as-is. The API's huge-* names are accepted too: huge- (or hugeicons:) is stripped, then the exact key is tried, then the key without a trailing -NN suffix (huge-download-01 -> download-01 -> download). Unknown names render nothing and log a warning (disable with config :ledger_ui, warn_unknown_icons: false).

Vendored icons

Icons outside the dictionary come from the app's own folder, filled by mix ledger_ui.icons (get, sync; see LedgerUI.Icons):

config :ledger_ui, :icons_path, "priv/hugeicons"

<.icon name="huge-invoice-01" />

They are loaded once into :persistent_term and render the same markup as the built-in ones. Order of lookup: a built-in key (exact, after dropping huge-), then a vendored file of that name, then the built-in key without its -NN suffix. So a built-in name always wins over a vendored file of the same name, while huge-download-01 finds the vendored download-01.svg before settling for the built-in download.

Box

boxed wraps the icon in a rounded square box (32px; 44px with box_size="lg"); tone colours it (accent/acc, success/pos, error/neg, warning/warn, info, lime, neutral). box_size="lg" gives the large box; any number of pixels sets width/height inline. The inner block replaces name.

<.icon>

Attr Type Default Values / notes
name :string nil Icon name (dictionary key or huge-*).
size :string "base" nil, base, lg, md, sm, xl - sm 14px, md 16px, base 18px, lg 22px, xl 28px (nil is base).
class :any nil
boxed :boolean false Wraps the icon in a rounded square box.
tone :string nil nil, acc, accent, error, info, lime, neg, neutral, pos, success, warn, warning - Box colour (needs boxed).
box_size :any nil "lg" or a size in pixels.
box_class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:inner_block> - Own SVG inside the box, instead of name.