AnimationPrefRespected [constraint] v1.0.0

All non-essential motion must respect prefers-reduced-motion: reduce. When the user has the OS-level setting enabled, decorative motion must be eliminated or replaced with an instant or sub-perceptual variant.

Target

• CSS transitions / animations
• JS-driven animations (Framer Motion, GSAP, Web Animations API)
• scroll-driven animations
• video autoplay

Severity

critical

Meta

• License: Apache-2.0
• License Provenance: package-authorship-claim

Values

• • Required: @media (prefers-reduced-motion: reduce) { /* zero or instant motion */ }
• • Required: JS animation libraries gated by useReducedMotion() / matchMedia('(prefers-reduced-motion: reduce)').matches
• • Required:
• • Forbidden: scroll-triggered parallax that ignores the preference
• • Forbidden: auto-playing carousels with no reduce-motion fallback
• • Forbidden: page-transition animations that always play regardless of preference

Exceptions

• Essential motion that conveys information (progress indicators, video that is the content itself).
• User-initiated direct-manipulation (drag, panning) — driven by gesture, not auto-played.
• Motion that has been reduced to opacity-only crossfades is acceptable as the reduced variant.

Approved Alternatives

• @community/constraint-reduced-motion (the operative rule, this constraint enforces compliance).
• Framer Motion: useReducedMotion() hook returns true → animate via opacity only.
• GSAP: gsap.matchMedia() with (prefers-reduced-motion: reduce) branch.

Enforcement

Lighthouse a11y audit. Manual: macOS Reduce Motion ON, full keyboard pass through every animated surface. CI: scan for animation/transition declarations not inside a prefers-reduced-motion @media query.

AnimationPrefRespected [constraint] v1.0.0

All non-essential motion must respect prefers-reduced-motion: reduce. When the user has the OS-level setting enabled, decorative motion must be eliminated or replaced with an instant or sub-perceptual variant.

Target

• CSS transitions / animations
• JS-driven animations (Framer Motion, GSAP, Web Animations API)
• scroll-driven animations
• video autoplay

Severity

critical

Meta

• License: Apache-2.0
• License Provenance: package-authorship-claim

Values

• • Required: @media (prefers-reduced-motion: reduce) { /* zero or instant motion */ }
• • Required: JS animation libraries gated by useReducedMotion() / matchMedia('(prefers-reduced-motion: reduce)').matches
• • Required:
• • Forbidden: scroll-triggered parallax that ignores the preference
• • Forbidden: auto-playing carousels with no reduce-motion fallback
• • Forbidden: page-transition animations that always play regardless of preference

Exceptions

• Essential motion that conveys information (progress indicators, video that is the content itself).
• User-initiated direct-manipulation (drag, panning) — driven by gesture, not auto-played.
• Motion that has been reduced to opacity-only crossfades is acceptable as the reduced variant.

Approved Alternatives

• @community/constraint-reduced-motion (the operative rule, this constraint enforces compliance).
• Framer Motion: useReducedMotion() hook returns true → animate via opacity only.
• GSAP: gsap.matchMedia() with (prefers-reduced-motion: reduce) branch.

Enforcement

Lighthouse a11y audit. Manual: macOS Reduce Motion ON, full keyboard pass through every animated surface. CI: scan for animation/transition declarations not inside a prefers-reduced-motion @media query.

Relations

related: [@community/constraint-reduced-motion, @community/fact-reduced-motion-priority, @w3c/source-wcag-22]

Rationale

Vestibular disorders, migraine, epilepsy, and motion sensitivity affect a substantial population. OS-level prefers-reduced-motion is their explicit signal. Ignoring it can trigger nausea, vertigo, or seizure. WCAG 2.1 SC 2.3.3 (AAA) and the broader 2.2 baseline expect the OS setting to be honored.