useReducedMotion

Detect the user's prefers-reduced-motion OS setting and reactively disable animations.

useReducedMotion() reads the prefers-reduced-motion: reduce media query and reactively updates when the user's preference changes. Use it to conditionally skip animations for users who have enabled reduced motion in their OS accessibility settings.

The hook returns false during SSR to avoid hydration mismatches, then updates to the actual preference on the client.

Return Value

TypeDescription
booleantrue if the user prefers reduced motion, false otherwise

Info

c15t's built-in components already respect prefers-reduced-motion internally. This hook is primarily useful when building custom UI with the headless approach.