Motion
Animation in Plane 1 must carry functional information. Decorative motion is prohibited.
Clinical Basis
Section titled “Clinical Basis”Two ADHD-specific failure modes drive the constraints:
- Layout shift on hover — displaces click targets during motor-imprecise moments. Prohibited.
- Translational excess — large sliding distances feel cinematic in demos, feel like waiting after 40 daily opens. Prohibited.
Motion Tokens
Section titled “Motion Tokens”| Token | Value | Use |
|---|---|---|
--motion-ease-calm | cubic-bezier(0.3, 0.0, 0.2, 1.0) | Large structural shifts — sidebar, view transitions. Slow, predictable deceleration. |
--motion-ease-organic | cubic-bezier(0.4, 0.0, 0.2, 1.0) | Standard state changes — hover, focus, selection. Natural physical inertia. |
--motion-duration-fast | 120ms | Micro-interactions — button press, tag selection |
--motion-duration-base | 180ms | Standard transitions — input focus, card hover |
--motion-duration-slow | 280ms | Structural transitions — panel open/close |
Semantic Shorthands
Section titled “Semantic Shorthands”| Token | Value | Use |
|---|---|---|
--motion-micro | 120ms ease-organic | Button press, tag toggle |
--motion-state-change | 180ms ease-organic | Focus, hover, selection |
--motion-structural | 280ms ease-calm | Panel open/close, view transitions |
Reduced Motion
Section titled “Reduced Motion”prefers-reduced-motion is a floor, not a ceiling. The system honours the OS preference and additionally provides an in-app motion intensity control. When reduced motion is active, all durations collapse to 0ms.
Saltie’s Motion
Section titled “Saltie’s Motion”Saltie’s animations use personality-timing, not UI-timing. Her motion budget is separate from Plane 1. Her entrance may have a deliberate 800ms delay because she’s deciding whether to bother. Saltie’s animation tokens are separate from the tokens above.
Hard Rules
Section titled “Hard Rules”- No layout shift on hover — element must not move as cursor approaches
- No large translational movement as primary transition
- No ambient motion on any Plane 1 element
- Plane 2 motion (the swamp) is exempt from these rules but never carries functional information