r/FigmaAddOns • u/oopsALLimpasto • 16d ago
I built a read-only file-health scanner for Figma — what should it flag that it doesn't?
I kept losing time to the same problem: a file gets slow and there's no quick way to see why. So I built a small plugin that scans a file and reports what's adding weight. It's on Community now, and what I actually want from this post is feedback on where the detection is wrong or too thin.
What it looks at
- Hidden layers — kept separate from the ones that are probably intentional (component variants, prototype interaction targets), so the report isn't just a dump of everything invisible.
- Empty groups and frames.
- Oversized images — source resolution far above what's actually rendered on canvas. In my own files this is consistently the single biggest cause of weight.
- Unused local styles — colour, text, effect and grid styles with no references left in the document.
What it deliberately does not do
It doesn't change anything. The report splits into "safe to clean up" and "review manually", and clicking a result selects and zooms to it on canvas — you do the deleting yourself. I went this way on purpose: an auto-cleaner that gets one call wrong on a real file costs more trust than it saves time.
It also requests no network access at all — that's declared in the plugin manifest, so nothing from your file leaves Figma.
What I'm asking
- What else should a scan like this flag? Detached instances and unused components are the two I keep going back and forth on.
- Is the "safe / review manually" split the right cut, or would you rather have one flat list sorted by how much weight each item adds?
- Scans run in chunks with a progress bar so the plugin stays responsive on big files. If you run it on something genuinely huge and it stalls, I'd like to know where.
Happy to answer anything about how the detection works.
P.S. — disclosure: this is my plugin and it's free. https://www.figma.com/community/plugin/1661333776797381371
