We often talk about design systems in terms of components and tokens.

But after working with large Figma files, I noticed that scalability often breaks down in much simpler ways:

Inconsistent naming
Duplicate components across pages
Deeply nested structures
Detached instances
Token usage drifting over time

Visually everything still looks fine, but structurally the system becomes harder to maintain.

As Figma files grow, structure quietly breaks.

Not visually structurally.

Naming gets inconsistent.
Duplicates pile up.
Tokens drift.
Design systems slowly lose discipline.

We realized there wasn t a way to objectively measure file health.