Skip to content

v1.2.0 — Block masked icons at scan time

Choose a tag to compare

@KinyooZ KinyooZ released this 30 Jul 02:11
· 2 commits to main since this release

What's new

Icons containing a <mask> are now blocked at scan time. Masked icons fail to publish, so the plugin stops them before they reach your repo instead of letting the publish break. The error names the icon and its category, and tells the designer exactly what to change:

  • Mask id contains inside → stroke alignment is set to Inside; change it to Center. (SVG only supports centered strokes, so Figma fakes "Inside" with a mask that clips the outer half.)
  • Otherwise → a layer or frame has Clip content enabled; uncheck it. If it really is a mask layer, flatten the shapes instead.

clipPath and gradients are not restricted. Neither affects publishing, and colored icons rely on linearGradient / radialGradient for their fills. Only the <mask> element itself is matched — an attribute reference like mask="url(#x)" won't trigger the check.

Install (no build needed)

  1. Download figma-icon-manager-v1.2.0.zip from the Assets below
  2. Unzip anywhere on your machine
  3. In Figma: Plugins → Development → Import plugin from manifest… → select the manifest.json inside the unzipped folder

Upgrading from v1.1.0? You can just replace the unzipped folder contents — no need to re-import in Figma as long as the folder path is unchanged.

Figma file convention (full list)

  1. At least one Page whose name contains icon (case-insensitive)
  2. Under that page, top-level Frames must end with Outlined, Filled, or Colored
  3. All icon Components must use PascalCase naming (e.g. ArrowUp)
  4. No duplicate names within the same category
  5. New in v1.2.0: no <mask> in the exported SVG

What is inside

  • manifest.json — Figma plugin manifest
  • dist/code.js — main plugin logic
  • dist/ui.html — plugin UI (React bundle inlined)

Full changelog: v1.1.0...v1.2.0