---
name: fractal-icons
description: "Select an existing Fractal icon or develop explicitly requested icon artwork. Prefer the fractal-icons package; creation follows the approved drawing and promotion workflow."
---

# Select or develop an icon

Read [core](../../../../core.md). Existing icon use activates `icon-use`; new/modified artwork activates `icon-create`.

## Existing icon

Search [the catalogue](../../../../shared/icons/catalogue.json) by the entry's `functions` and inspect the installed `@mirror-physics/fractal-icons` exports. Choose by meaning in context, then verify the actual form. Do not infer an export name from a prose label or assume the catalogue matches an older installed version.

Use the package in code. When a standalone artifact needs raw SVG, retrieve the selected approved asset from the production Fractal source or its hosted `https://design.mirrorphysics.com/design/icons/svg/` location. The catalogue's `file` values are relative to that production icon directory; shared/icons/catalogue.json links to the single canonical catalogue in design/icons. Inspect the retrieved artwork before using it. If package/source versions disagree, report it rather than drawing a substitute.

Inherit the surrounding foreground through `currentColor`. Meaningful standalone icons need accessible names; decorative icons alongside text are hidden from assistive technology. Verify actual size and alignment with neighboring text/controls.

## New or modified artwork

Check the catalogue before drawing, then read [the drawing specification](../../references/icons/drawing.md). Follow its 32-unit geometry, proportional 2-unit stroke, optical size by shape, single-color treatment, small-feature exceptions, and family parity/disparity checks. Review at 16px alongside real neighbors.

A requested local prototype remains an app-local SVG/component for review. Do not edit the shipped SVG directory or generated catalogue by hand. Approved artwork goes through `fractal-testing` promotion into production Fractal, followed by `fractal-icons` sync/build and its documented GitHub Actions release workflow. Keep that public package free of internal evaluation/migration details.

The rewrite itself does not authorize promotion, publication, or a new authoritative icon set.
