Repository navigation
Releases
v1.2.1 — Better guidance on the mask error
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)
- Download
figma-icon-manager-v1.2.1.zipfrom the Assets below - Unzip anywhere on your machine
- In Figma: Plugins → Development → Import plugin from manifest… → select the
manifest.jsoninside 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 manifestdist/code.js— main plugin logicdist/ui.html— plugin UI (React bundle inlined)
Full changelog: v1.2.0...v1.2.1
v1.2.0 — Block masked icons at scan time
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)
- Download
figma-icon-manager-v1.2.0.zipfrom the Assets below - Unzip anywhere on your machine
- In Figma: Plugins → Development → Import plugin from manifest… → select the
manifest.jsoninside 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)
- At least one Page whose name contains
icon(case-insensitive) - Under that page, top-level Frames must end with
Outlined,Filled, orColored - All icon Components must use PascalCase naming (e.g.
ArrowUp) - No duplicate names within the same category
- New in v1.2.0: no
<mask>in the exported SVG
What is inside
manifest.json— Figma plugin manifestdist/code.js— main plugin logicdist/ui.html— plugin UI (React bundle inlined)
Full changelog: v1.1.0...v1.2.0
v1.1.0 — Sync icon library on publish
What's new
Icon library now stays in sync with your Figma file. When you rename or delete an icon in Figma, the corresponding file in the GitHub repo is cleaned up on the next publish — no more stale components lingering after a rename.
Install (no build needed)
- Download
figma-icon-manager-v1.1.0.zipfrom the Assets below - Unzip anywhere on your machine
- In Figma: Plugins → Development → Import plugin from manifest… → select the
manifest.jsoninside the unzipped folder
Upgrading from v1.0.0? You can just replace the unzipped folder contents — no need to re-import in Figma as long as the folder path is unchanged.
Managed scope (what gets cleaned up)
Only plugin-generated files are touched:
{basePath}/index.tsand{basePath}/types.ts{basePath}/{outlined,filled,colored}/*.tsx{basePath}/{outlined,filled,colored}/index.ts
Any other files under basePath (README, hand-written helpers, etc.) are left alone.
What is inside
manifest.json— Figma plugin manifestdist/code.js— main plugin logicdist/ui.html— plugin UI (React bundle inlined)
Full changelog: v1.0.0...v1.1.0
v1.0.0 — First public release
Install (no build needed)
- Download
figma-icon-manager-v1.0.0.zipfrom the Assets below - Unzip anywhere on your machine
- In Figma: Plugins → Development → Import plugin from manifest… → select the
manifest.jsoninside the unzipped folder
What is inside
manifest.json— Figma plugin manifestdist/code.js— main plugin logic (runs in Figma sandbox)dist/ui.html— plugin UI (React bundle inlined)
Highlights
- Scan Figma icon library → generate React components → one-click publish to GitHub
- Three categories: Outlined / Filled / Colored with smart color handling
- PascalCase naming validation with clear error messages
- Single atomic commit per publish via GitHub Git Data API
- Persistent config via
figma.clientStorage
For developers
Clone the repo and run npm install && npm run build — see the README.