Skip to the content.

Icons

Site and admin icons are Lucide through @nuxt/icon, rendered as inline SVG. They replaced the PrimeIcons icon font (package and CSS removed).

Why SVG, not an icon font

Concern Inline SVG (Lucide) Icon font (PrimeIcons, removed)
Responsive Crisp at any size; sized in em, follows text Font hinting blurs at odd sizes
Accessible currentColor, works in forced-colors / high-contrast mode; unaffected by user font overrides (e.g. dyslexia fonts) Glyphs break or vanish under font overrides
Touch Icon sits inside a 44px control; never the target on its own Same
Weight Only the icons used are bundled Whole font downloaded for ~14 icons
Coverage ~1,500 icons incl. 3D, audio, video, documents (admin media) ~300

Using icons

//- Decorative (default): aria-hidden, the control carries the name
UiButton(label="Copy", icon="copy")
UiIcon(name="download")

//- Icon-only control: name the control, not the icon
UiButton(icon="x", aria-label="Close details")

//- Standalone meaningful icon (rare): label → role="img"
UiIcon(name="triangle-alert", label="Warning")

One icon set

Owner decision 2026-10-14: Lucide via UiIcon is the one icon set. It is passed into PrimeVue icon slots (UiButton, UiTag, UiChip); PrimeVue’s built-in @primevue/icons stay where the component draws them (close buttons, chevrons). No icon fonts, and no text glyphs (✓ ✕ ◷ ↗ → ←) acting as icons: tests/icon-glyphs.spec.ts scans every template. Direction cues use arrow-left / arrow-right, external links external-link, status check / x / clock; each name must be in clientBundle.icons in both apps.

AppSocialLinks (core/web/app/components/AppSocialLinks.vue) renders contact.social from content/profile.json plus the contact email — see footer-and-social-links.md. Each link’s icon is a Lucide name and must be in web’s clientBundle.icons (or TGMC_BASE_ICONS).

Configuration

@tgmc/nuxt-layer-base owns the setup (packages/nuxt-layer-base/src/config/icons.ts, tgmcIconConfig()), so both apps get it by extending the layer: