Icons
@combric/icons is Combric’s public icon package. It ships Iconoir-derived
regular and solid icons for React, CSS masks, original SVG assets, and typed
metadata. The package is usable independently of @combric/react.
Browse regular icons · Browse solid icons
Install
npm install @combric/icons@1.3.1React is an optional peer dependency for React icon exports and must satisfy
>=19.0.0 <20. CSS, SVG, and metadata consumers do not need React.
Import the smallest useful surface
The root entry point exports regular React icons. Use a named import with a modern bundler for the normal React pattern:
import { ActivityIcon } from "@combric/icons";Solid icons use their own entry point:
import { ActivityIcon } from "@combric/icons/solid";When a direct module better suits a consumer’s bundling strategy, use the per-icon regular subpath:
import { ActivityIcon } from "@combric/icons/regular/activity";Avoid a full namespace import such as import * as Icons: it obscures which
icons the application needs. The catalogue below uses metadata only and never
loads a namespace of SVG React components.
React
Icons are decorative by default, with aria-hidden="true" and
focusable="false". Give an icon its own accessible meaning only when it
communicates information independently, using aria-label, aria-labelledby,
or title:
import { ActivityIcon } from "@combric/icons";
export function ActivityStatus() { return <ActivityIcon aria-label="Recent activity" />;}Use size, width, height, color, strokeWidth, className, and standard
SVG props as needed. A title or ARIA label turns the SVG into an image role;
do not add one when nearby visible text already supplies the meaning.
React component slots
@combric/react intentionally accepts ReactNode for every icon slot. It is
not coupled to @combric/icons or Iconoir: another React icon library or a
custom compatible React node works equally well. Combric Icons is the official
reference implementation.
import { ActivityIcon, ArrowRightIcon } from "@combric/icons";import { Button } from "@combric/react";
export function SaveProject() { return ( <Button leadingIcon={<ActivityIcon />} trailingIcon={<ArrowRightIcon />}> View activity </Button> );}Every slot listed below has type ReactNode and is wrapped by the component as
decorative content (aria-hidden="true"). The control or heading must retain
its own visible text or accessible name; a labelled SVG inside a slot does not
become the component’s accessible name.
| Component | Public prop | Placement |
|---|---|---|
Button |
leadingIcon, trailingIcon |
Leading / trailing |
Toggle |
leadingIcon, trailingIcon |
Leading / trailing |
ToggleGroupItem |
leadingIcon, trailingIcon |
Leading / trailing |
AccordionTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
CollapsibleTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
Badge |
leadingIcon, trailingIcon |
Leading / trailing |
Label |
leadingIcon, trailingIcon |
Leading / trailing |
FieldLegend |
leadingIcon, trailingIcon |
Leading / trailing |
BreadcrumbLink |
leadingIcon, trailingIcon |
Leading / trailing |
BreadcrumbPage |
leadingIcon, trailingIcon |
Leading / trailing |
BreadcrumbSeparator |
icon |
Separator |
PaginationLink |
leadingIcon, trailingIcon |
Leading / trailing |
PaginationPrevious |
icon |
Leading |
PaginationNext |
icon |
Trailing |
TabsTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
DropdownMenuTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
DropdownMenuItem |
leadingIcon, trailingIcon |
Leading / trailing |
PopoverTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
TooltipTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
DialogTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
DialogClose |
leadingIcon, trailingIcon |
Leading / trailing |
DialogTitle |
icon |
Title |
DrawerTrigger / SheetTrigger |
leadingIcon, trailingIcon |
Leading / trailing |
DrawerClose / SheetClose |
leadingIcon, trailingIcon |
Leading / trailing |
DrawerTitle / SheetTitle |
icon |
Title |
ToastClose |
leadingIcon, trailingIcon |
Leading / trailing |
ToastTitle |
icon |
Title |
CardTitle |
icon |
Title |
AlertTitle |
icon |
Title |
EmptyStateMedia |
icon |
Media |
EmptyStateTitle |
icon |
Title |
For an icon-only button, give the control—not its slot—a name:
import { ActivityIcon } from "@combric/icons";import { Button } from "@combric/react";
export function OpenActivity() { return ( <Button aria-label="Open activity"> <ActivityIcon /> </Button> );}The component catalogue contains live reference examples for Button, Breadcrumb, Dropdown Menu, Dialog, Card, and Empty State.
CSS
CSS masks are available without React. Import only the style you use in a given application surface:
@import "@combric/icons/css/regular";
.save-mark { color: var(--combric-color-accent);}<span class="combric-icon combric-icon-save save-mark" aria-hidden="true"></span>Use @combric/icons/css/solid for solid icons. The combined
@combric/icons/css entry point includes both styles; keep regular and solid
imports separate when only one is needed.
SVG and metadata
Original SVG assets are available to bundlers from their public subpaths:
import saveSvg from "@combric/icons/svg/regular/save.svg";The typed metadata entry point is intended for developer tools, catalogues, and search—not for maintaining a duplicate icon list:
import { iconCatalog, iconNames, type IconName } from "@combric/icons/metadata";
const names: readonly IconName[] = iconNames;const componentNames = iconCatalog.map((icon) => icon.componentName);@combric/icons/metadata.json is the matching JSON surface for non-TypeScript
tools. The catalogue pages on this site are driven by the typed metadata entry
point.
Browse the catalogue
Use the source-backed browser for fast name/component search and copyable imports. Each result page renders at most 48 cards, so searching thousands of SVGs does not turn into a large simultaneous DOM mount.
