Skip to content

v1.2.1 — Better guidance on the mask error

Latest

Choose a tag to compare

@KinyooZ KinyooZ released this 31 Jul 07:53

Copy-only follow-up to v1.2.0. The mask rule itself is unchanged — only the guidance it gives you.

What's new

The mask error now points at boolean shapes first. In practice this rule almost always fires on a Union / Subtract: the merge itself exports fine, it's the stroke left on the merged shape that Figma turns into a <mask>. The error now names that as the first thing to check.

Outline Stroke is now the recommended fix, ahead of switching alignment to Center. Both remove the mask, but Center shifts the stroke outward by half its width and changes how the icon looks — Object → Outline Stroke converts the stroke to a filled shape and keeps the appearance identical.

Before:

描边对齐设成了「内部 Inside」,请改为「居中 Center」

After:

有描边的对齐是「内部 Inside」。请重点检查 Union / Subtract 等布尔拼合形状——拼合后那圈描边往往没轮廓化。选中该形状执行「轮廓化描边 Outline Stroke」把描边转成填充,外观不变;也可把对齐改为「居中 Center」,但描边会外扩半个线宽

Wording corrected from "无法发版" to "不允许发布". The rule is a design-system constraint, not a build requirement — icons carrying a mask do publish successfully, so the error no longer claims publishing would fail. (The build failure this rule was originally associated with came from the mask-type style attribute, fixed at the generator level back in v1.1.x.)

README and the landing page carry the same updated guidance.

Install (no build needed)

  1. Download figma-icon-manager-v1.2.1.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.2.0? Replace the unzipped folder contents — no need to re-import in Figma as long as the folder path is unchanged.

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.2.0...v1.2.1