Appearance
Status & Warnings


Variable Count Pill
The global header (top toolbar) shows a single pill: {total} total · {generated} gen · −{N} dup · {modes} modes · {col} col next to the colored status dot. Both share the same segmented-control container as the section nav on the left and the preview filter toggles (bg-muted outer, bg-background + shadow-sm active item).
The · −{N} dup segment is conditionally rendered — when there are no duplicates, the entire segment (including its leading bullet) is omitted, so the line stays clean for fresh themes.
When you hover a theme in the theme select, this pill recomputes locally for the hovered theme without writing to the store. Pulse animation is bound to actual stored values so hover preview doesn't trigger flicker.
Status Indicators
- Green — everything valid, ready to push
- Orange — warnings present (e.g. duplicate state names, near variable limits)
- Red — errors that block push (over variable limits, validation failures)
The status-dot button (24×24) toggles the Warnings panel below the header — an amber list of all current validation warnings (empty contexts, missing colors, duplicate names, over-limit collections). Clicking the count pill itself opens the Collection Grid panel with per-collection variable counts and limit progress bars.
Warning Types
- State with no events assigned
- Entity with no colors assigned
- Collection approaching or exceeding 5,000 variable limit
- Duplicate sanitized names
All warnings are non-blocking except variable limit exceeded, which prevents Push Vars until resolved.
Structure recommendation
When a theme's collection layout could be simplified (e.g. variables fit comfortably in a single Compact collection but you're on Balanced), the Collection Grid panel surfaces a soft suggestion — All N variables fit in one collection — Compact would simplify your setup. — with a one-click Switch to Compact button. Recommendations are soft signals only: the status dot stays green, since this isn't a real warning. Only over-limit + true validation failures escalate the dot's colour.