diff --git a/ui/INVARIANTS.md b/ui/INVARIANTS.md new file mode 100644 index 0000000..bedb9db --- /dev/null +++ b/ui/INVARIANTS.md @@ -0,0 +1,31 @@ +Visual intent: +- Modern +- Confident +- Technical +- High-signal + +Animation principles: +- Animation communicates state or priority +- Animation is purposeful, not decorative +- Motion is fast and subtle + +Allowed animation: +- Severity change (escalation/de-escalation) +- New finding arrival +- Hover affordances +- Panel expand/collapse +- Workflow transitions + +Restricted animation: +- No looping animations +- No animation that blocks interaction +- No animation longer than 300ms +- No animation on critical-path actions + +Graphics: +- Data-driven visuals encouraged +- Motion may reinforce severity or confidence +- Visual emphasis must align with severity + +Rule: +Flash is allowed when it clarifies meaning.