Figma Plugin

Scan is read-only

Scan compares the current Figma source against Stil Cloud and shows what changed. It must not create nodes, write plugin data, change variable modes, or mark a Figma Library as modified. Sync is the step that saves selected changes to Stil Cloud.

Warnings do not block Sync by default

Duplicate names, duplicate token paths, generic Figma names, and typo-like names are shown as warnings so the team can review them. They remain selected for Sync by default because two similar entries may be intentional. Component read errors are different: if Figma cannot expose a component set's properties, Stil treats that item as a blocker until the Figma source is fixed.

How to clear warnings

To remove a warning completely, fix the source that creates it. For public tokens, use distinct token paths or intentionally separate collections. For public components, give each exported component a meaningful, unique name. If a component is only a private helper or structural layer, prefix the relevant name segment with . or _ to hide it from public Stilbook lists and search while still allowing it to be used structurally. Use .. or __ only for internal structural groups that should stay out of the public component inventory.

Public components:
Button / Primary
Button / Secondary

Private structural helpers:
Button / .Icon slot
Card / _Layout

Internal structural groups:
..Legacy
__Scaffold