Figma Limits

Variable limits

Figma imposes hard limits on variables:

• 5,000 variables per collection -- Systema tracks this per collection and shows a progress bar inside the header pill's expanded panel. Collections exceeding the limit are flagged in red and Push Vars is blocked.
• No limit on total variables -- but large numbers (10,000+) slow down Figma. Systema shows a confirmation dialog when pushing more than 5,000 total variables.

Paid plan detection

Figma's free plan does not support multiple modes in a variable collection. Systema detects this at startup:

1. Creates a temporary collection
2. Attempts to add a second mode via collection.addMode()
3. If it succeeds → paid plan → enables Push Vars
4. If it throws → free plan → disables Push Vars with a tooltip explaining why
5. Cleans up the temporary collection

This check runs once on plugin load. The result is stored in canCreateVars state.

Header pill calculation

The global header pill (top of the plugin window, next to the theme selector) shows a live summary:

44,109 total · 27,821 gen · −16,290 dup · 2 modes · 27 col

• total = generated + skipped duplicates (theoretical maximum)
• gen = actual tokens that will become Figma variables
• dup = tokens skipped because all modes produced identical (clamped) colors
• modes = number of enabled modes
• col = number of collections

The collection grid (expandable) shows each collection with a capacity bar (green < 60%, yellow < 90%, red ≥ 90%).

---