Design SystemGuidelinesIcons

Icons

只用 Untitled UI line icon

全站 icon 只有一個來源:@untitledui/icons 的單色 line icon(1,100+ 顆)。 檔案類型用 @untitledui/file-icons。同一套線條粗細與圓角,畫面才會像同一個產品。

Home01 · Settings01 · Star01 · TrendUp01 · ChevronDown

production 的 @olab/components 也有自己的 Icon,筆畫偏粗;放在 Untitled UI icon 旁邊會打架時,不硬用,以 Untitled UI 為準(2026-09-28 裁決)。

尺寸與顏色

三個尺寸

size-416px · 行內、按鈕 sm、表格列
size-520px · 按鈕 md、列表項、一般 UI 預設
size-624px · 導覽、卡片標題、featured

怎麼寫

  • Named import,可 tree-shake:import { Home01 } from "@untitledui/icons";
  • 傳給組件 prop 時傳參照:<Button iconLeading={ChevronDown}>;寫成 JSX 元素時一定加 data-icon。
  • 顏色走 semantic text token:text-primary、text-tertiary、text-brand-main——不用 raw 色。
  • 純裝飾的 icon 加 aria-hidden;有意義的 icon 旁邊要有文字或 aria-label。
  • 筆畫粗細預設即可;要調用 strokeWidth,不用 CSS 偽造。

禁止事項

  • 彩色 emoji 當 icon(🔥 📈 ✅)——這是「AI 做的」最明顯的痕跡,任何畫面都不用。
  • 混用第二套 icon 庫(Lucide、Heroicons、Material…),即使形狀相近。
  • 自己畫 SVG 取代現有 icon;真的沒有對應 icon 時先回報,不要自創。
  • 用 size-3、size-7 這類不在三階裡的尺寸,或用 arbitrary value 調大小。