Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
Macro interface icons
Original SVG drawings for Macro's interface. The source of truth is the SVG files in this directory. These drawings were authored on a blank coordinate grid; no Apple, OpenAI, Linear, or Phosphor vector paths were imported or traced. SF Symbols and ChatGPT were visual references for optical balance and clarity, not asset sources. The icons have no platform font or native symbol dependency.
Apple's design guidance informs optical balance, not asset reuse. Do not import, trace, or modify SF Symbols exports or templates for this cross-platform set. The original source geometry and this provenance note are not a legal clearance or a guarantee of non-infringement. Apple's supplied images have separate platform-restricted terms.
Drawing system
- A
0 0 24 24viewBox. Most pictograms occupy an 18–19 unit optical area; round and diagonal forms can overshoot it to appear equally large. - Regular strokes are 2 units: approximately 1.67 CSS px at a 20 px navigation size and 1.33 CSS px at a 16 px toolbar size. Internal details can use lighter strokes to preserve their negative space. Bold entity glyphs use 2.3 units.
- In the app,
icon-styles.cssoptically adjusts those default strokes to 1.7 / 2 units in light themes. Dark themes retain 2 / 2.3. At 20 px, the light regular stroke is about 1.42 px. Colors and filled silhouettes stay unchanged. Theme-scoped variables also support the gallery's nested themes. - Rounded joins and terminals, restrained 2–3 unit corner radii, open counters, and few internal details. Macro's diagonal rhythm appears in folds, tails, branches, and the angular four-point agent mark.
- Active navigation variants keep their regular counterpart's optical center and silhouette. Cutouts are transparent, never theme-colored.
currentColorowns both stroke and fill. Do not applyfill-currentto an outline glyph or reuse stroke overrides designed for a 256-unit viewBox.
Use
Import individual SVGs so unrelated drawings stay out of the startup bundle:
import SearchIcon from '@icon/system/regular/magnifying-glass.svg';
<button aria-label="Search"><SearchIcon class="size-4" /></button>
Use 20 px for rail navigation, 16 px for header actions and status glyphs,
and 14 px for compact secondary controls. Keep the enclosing hit target
independent of the drawing size. Avoid scaling detailed glyphs below 14 px.
SVGs are decorative by default; put accessible names on their controls.
For a meaningful standalone glyph with its own accessible label, explicitly
set aria-hidden={false} so the default does not hide its status or label.
Property status option glyphs are decorative too: their surrounding value or
menu label names the status. Standalone TaskStatusIcon identity glyphs retain
their accessible status label.
The existing semantic filenames make the migration explicit at each import.
Several equivalent concepts (for example folder and folder-simple) share
the same drawing to avoid introducing competing silhouettes. Existing brand
logos and the legacy animated showcase retain their own assets and licensing.
Interface controls, including editor tools, file types, task states, priorities,
and settings, use this family. Board views use the shared Kanban drawing: three connected columns with
staggered bottoms and open counters, following the familiar Phosphor silhouette. Gantt layouts use chart-gantt, with staggered horizontal task bars;
it is also listed in the regular icon gallery. Brand marks retain their existing assets.
Icons introduced on main after the source PR retain their existing assets when
this family has no matching drawing.
Urgent priority uses priority-urgent-fill, a filled rounded square with rounded
exclamation-stem and dot cutouts. Its dedicated priority-urgent token maps to
the theme's orange rather than warning or accent.
Task status rings use a 2.25-unit stroke: task-created is a plain hollow ring,
task-in-progress adds a counterclockwise half pie from 12 o'clock, and
task-in-review adds a counterclockwise three-quarter pie. Both pies use a 6-unit
radius with a 1.875-unit gap to the ring's inner edge. Not started keeps its
neutral color, with no shadow or highlight. Completed and Canceled use the
status-specific task-completed-fill and task-canceled-fill discs with transparent
check and cross cutouts; keep generic check-circle and x-circle icons separate.
Empty priority uses ../wide-priority-none.svg: the same 18×12 ascending bars,
color, and display box as Low/Medium/High, with all three bars at 30% opacity in
the SVG and no additional empty-icon dimming. Empty assignees use
user-circle-dashed, a dashed ring around a filled person. Set projects use
cube; empty projects use cube-dashed, with a dash at every corner rather than
a dashed stack. Use the same dashed cube for empty Project values in title pills,
list cells, side-panel values, and group headers.
Draw the cube's dash gaps as explicit segments; pathLength-normalized dashes
become solid when SVG optimization merges the individual edges.
Empty Due date values use calendar-slash in list cells, title pills, side-panel
values, board cards, and no-due-date group headers; populated dates keep their
existing calendar icon. Keep both icons at their surface's existing size.
Task statuses use independent task-status-not-started, task-status-in-progress,
task-status-in-review, task-status-completed, and task-status-canceled theme
tokens for icons and group-header tints. Their defaults are muted gray, blended
amber, violet, accent, and muted gray respectively. In Progress mixes amber with
content-0 in sRGB: 80% amber in dark mode and 85% in light mode, improving contrast
without rotating amber toward a tinted foreground's hue. Authored overrides stay
unchanged.
Status and Priority option glyphs share a 12 px default, including title property
pills. Status and Priority selector dropdowns use 16 px icons on desktop and touch,
including empty-value options. Explicit caller sizing takes precedence: leading task
status controls use 18 px, leading priority controls use 16 px on desktop and
20 px on phones, and side-panel values use 16 px. Leading priority glyphs never
flex-shrink. Group-header carets use 16 px; hit targets stay unchanged.
Prefer one recognizable silhouette and only the detail needed to identify its
action. Chat variants share one bubble, task variants one checked square,
people variants two figures. The CRM icon retains its stepped building silhouette.
The connector plug stands upright: two prongs over a 13-unit rounded body and a
short cord, filling the same optical area as its navigation neighbors; plugs
shares the drawing.
Office glyphs use two sparse rows of windows and a baseline to avoid a face-like
appearance. Keep the selected calendar header open around its binding posts,
quote heads closed with trailing tails, and the filter recognizable as a funnel.
Calendar dots, extra signal arcs, and decorative tool details are omitted.
Keep meaningful distinctions such as mute slashes, warning marks, file-type
symbols, and ordered-list numbers. The shared ../share.svg also appears in the
gallery and follows the same theme-aware stroke rules.
File-type marks use 1.5-unit interior strokes in both weights to keep their
small counters open; the surrounding page retains the normal family weight.
Settings navigation and its page controls use this same set, including the
appearance, keyboard, usage, billing, runtime, integration, and developer icons.
Inactive settings rows use muted ink; selection and hover supply emphasis.
Optical review principles
Apple's interface icon guidance informs the review: match the perceived weight of adjacent text, simplify detail, and adjust each glyph's dimensions and padding for optical balance. The 24-unit grid and stroke values above are Macro's drawing choices, not Apple requirements. Center the visible shape, not only its bounding box; inspect its baseline and cap height relationship when it sits beside a label.
Use outlines for ordinary toolbar and list actions. A filled counterpart can emphasize selection, but it should preserve the original shape's visual position. Review both variants at their actual size and contrast, following Apple's SF Symbols guidance. These are composition principles; the drawings remain independently authored.
Interaction motion
icon-motion.ts is installed once by the app shell. It delegates pointer presses
and keyboard/assistive-technology clicks to the leading action glyph in buttons,
links, tabs, command options, and menu items, including portal menus and newly mounted controls.
All existing and newly authored data-macro-icon SVGs inherit this behavior.
- Keep feedback brief and finite: 320 ms on press, 280 ms on hover. Use a small press-and-settle, a restrained turn for settings, tilt for folders/mail, or lift for sharing. Do not bounce continuously or delay the action.
- Hover is limited to search, settings, and add glyphs after 160 ms of pointer intent. Touch does not trigger hover. Most icons respond only to press. The agent sparkle stays still.
- Animate the drawing, never its label, hit target, selection background, or layout. Individual transform properties preserve existing layout transforms.
- Put
data-icon-motion-targeton a fixed-size wrapper when an action swaps SVGs (asNavGlyphdoes). Both variants then move as one without a position jump. - Static glyphs, disclosure arrows, state/check indicators, loading spinners,
disabled/busy controls, and illustrations larger than 32 px stay still.
Add
data-icon-motion="none"on a glyph or ancestor for other stateful icons or controls that own their own motion. Do not add decorative motion to status. - Respect
prefers-reduced-motionfor every effect, including hover; preference changes cancel in-flight animation. Rapid presses replace rather than stack. - New semantic motion belongs in this shared module, not individual consumers. Draw original paths and motion; references such as Grok inform restraint and timing, never asset reuse. No new animation runtime is needed.
Review
Open /app/debug/icon-gallery in the running app. The original family is the
default view; the legacy animated gallery remains available. Review the actual
14/16/20/24 px drawings on both Macro themes, then check the affected app view.
Do not judge a toolbar icon solely from a large preview. Use the weight tabs
and navigation buttons to check emphasis without a size or position jump.
After changing geometry, update its bold/active counterparts and inspect them together. Test the real app on a standard-density display as well as Retina; SVG portability alone does not verify Windows rendering.
Small-size review
Compare altered silhouettes in light and dark at 14, 16, 20, and 24 px, including filled and bold counterparts. Review selected calendar glyphs with a countdown badge to ensure the binding header remains recognizable.
![]()