Icon catalog

The @simurgh-ui/icons package contains 474 functional icons for navigation, actions, status, files, and layout. Every icon is available as a named React, Vue, or Angular component, as a dynamic SimurghIcon, as framework-neutral data, and as an individual SVG file.

Install

pnpm add @simurgh-ui/icons

Install the peer for the framework entry point you use. The framework packages are optional peers, so a React application does not need Vue or Angular.

Choose an import

Need	Import	Guidance
Static application icon	`@simurgh-ui/icons/react`, `/vue`, or `/angular`	Prefer a named component so bundlers can remove unused icons.
Icon selected from data	Framework `SimurghIcon`	Pass a typed kebab-case `name`.
Server-generated markup	`renderIconSvg` from `@simurgh-ui/icons`	Returns an SVG string; only use trusted icon names and options.
Custom renderer or browser	`icons`, `iconNames`, `iconGroups`, or `getIcon`	Framework-neutral definitions and discovery metadata.
Static asset	`@simurgh-ui/icons/svg/<name>`	Use when a component import is unavailable or unnecessary.

See Usage and API for framework examples and customization, and Accessibility and RTL before placing an icon in an interactive control.

Accessible patterns

These live catalog examples distinguish a decorative icon, a standalone informative image, and a named icon-only control. Inspect the rendered semantics as well as the visible treatment.

Decorative beside text

Download report

The visible label carries the meaning, so the SVG stays hidden from assistive technology.

Standalone informative icon

The SVG is an image with a concise accessible name because no equivalent text is present.

Named icon-only control

The button owns the name and focus; its child SVG remains decorative and unfocusable.

Complete catalog

Search by name or familiar concepts such as “delete,” “profile,” or “back,” then choose the copy format your framework needs. The visible categories simplify discovery while each card shows its more precise implementation group.

Choosing between similar icons

Use message for one conversation, messages for several, and message-dots for an active or composing conversation.
Use user for a person, profile for an account destination, and user-card or profile-card when the surrounding object is a record.
Use map-pin for a place, current-location for the user’s detected position, and navigation-arrow for heading or travel direction.
Use file for one document, files for a collection, and folder for a container.

474 icons

Last verified on 2026-08-13 against Simurgh registry 0.1.1.