Icons
StartHDS icon names and rendering contract
Use a stable icon name in product specs and render <span class="hds-icon" data-hds-icon="users" aria-hidden="true"></span>. StartHDS core JavaScript owns the registry and injects the inline SVG. Unknown icons fall back to circle.
Component examples should compose optional decorative icon spans inside existing buttons, links, cards, alerts, appbars, tabbars, search controls, and dashboard surfaces. Keep adjacent text and aria-label names authoritative; icon-only buttons must provide aria-label.