NV Elements Catalog Starters Repo System Themes About Getting Started Changelog Metrics Support Accessibility Contributions Requests Migration Integrations Installation MCP CLI Lint Angular Bundles Extensions Golang Hugo Import Maps Lit NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue Foundations Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Panel Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Icon

stable:  0.1.1 Coverage: 68.00% Bundle: 18.22kb Lighthouse: 100 Axe Core Released: 0.1.3
Overview API Examples

An icon is a graphic symbol designed to visually show the purpose of an interface element.

Installation
CLI / MCP

All Icons

The Iconography system exposes an SVG based icon library to the nve-icon element.

See the searchable Interactive Icon Catalog

Status

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.

Status Description warning Indicates cautionary actions that require careful consideration before proceeding. danger Signals destructive or irreversible actions that need extra attention and confirmation. success Represents positive outcomes, confirmations, or constructive actions. accent Highlights important actions or draws attention to primary interactive elements.

Semantic color variations to communicate different states, priorities, and contextual meanings in user interfaces.

Size

Controls the visual scale of an element to match its importance and available space.

Size Description sm Compact size for dense layouts or secondary elements with less visual prominence. md Standard size that works well in most contexts and provides balanced visibility. lg Larger size for emphasizing important elements or improving touch targets in spacious layouts. xs xl

Icon size variants to accommodate layout densities, touch targets, and visual hierarchy requirements.

Direction

Sets the direction of the icon. Only supported by expand-panel/collapse-panel (horizontal axis) and arrow/caret/chevron icons (4-directions)

Direction Description up down left right

Directional icons for navigation, movement, and spatial relationships, providing clear visual cues for user actions.

Themes

Icon appearance across light and dark themes, ensuring proper contrast and visibility in different visual environments.

Registration

Register SVG paths and make them accessible to the <nve-icon> element. Define icons via a string or async function returning the resulting string.

Alias

Alias icons to a different name. This supports context-specific names or migrations between icon sets.

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days