Skip to content

An open source design system that's fully customizable and agent ready

TypeScript
12.4 KB
Raw Blame

schema_version: 1 template_version: 2 kind: design id: design:reduced-motion authority: current archive_reason: null superseded_by: null approved_by: cixzhang approved_at: 2026-10-24 owners: [cixzhang] review_triggers: [motion, interaction, accessibility] verified_by: [ scripts/check-knowledge.mjs, packages/core/src/tests/ReducedMotionPress.a11y.chromium.spec.ts, ] architecture: [architecture:interaction-modality] components: [] families: []

deciding_specs: []

Reduced motion design specification

{
  "paths": ["packages/core/src/**"]
}

User intent

A person who asks their device to reduce motion still sees every change Astryx shows, with no travel, scaling, or springing. On a touch screen a change cross-fades, as iOS does with Reduce Motion and Prefer Cross-Fade, except an in-place value change and a hover or selection color, which apply at once; with a mouse, trackpad, or keyboard the change is immediate.

Design principles

  • DR1 — No travel under reduced motion. While the person prefers reduced motion (prefers-reduced-motion: reduce), a transition that a core component animates — an entrance, an exit, a switch between presentations, or a change of state — MUST NOT move, scale, resize, or spring its content. DR2 and DR3 say what each pointer gets instead.

Anatomy and hierarchy

Role Purpose Required relationship
origin state What the person sees before the change Leaves without moving
destination state What the person sees after the change Appears in its final place, size, and order
cross-fade Connects the two states on a touch screen Changes opacity only, 200 ms or less
direct movement Content the person moves with their own hand Follows the pointer or finger, and coasts on after a throw (DR2); it is not a transition

State representation

State Required representation Allowed variation
reduced motion, coarse pointer Opacity-only cross-fade of 200 ms or less (DR2); in-place values and colors apply at once (DR2) A shorter cross-fade
reduced motion, any other pointer Immediate change (DR3), except a touch drag's release (DR2) None
no reduced-motion preference, theme on 'system' Outside this record Component and theme motion
a theme on 'always' (DR2a) As reduced motion, whatever the person's setting DR1–DR3

Responsive and input behavior

  • DR2 — Touch presentations cross-fade. Under reduced motion, when the primary pointer is coarse (pointer: coarse), or when the release of a touch drag starts the transition, each DR1 transition MUST change opacity only and MUST finish in 200 ms or less. An entering element appears in its final place and fades in; a leaving element fades out where it is. Momentum that continues a throw after release, a decay coast and its settle at an edge, is direct movement and does not cross-fade, as scrolling keeps decelerating under iOS Reduce Motion. A transition a component starts on release, such as snapping to a detent, dismissing, or paging to a target, still cross-fades. Native scrolling is the browser's and is untouched; a coast Astryx animates itself after a throw behaves like native momentum under Reduce Motion. An in-place value change, such as a progress fill's length or another continuous value, does not cross-fade: under reduced motion it applies at once on any pointer, with no added element (DEC-3). A control's hover or selection color, such as SelectableCard's selection border and ring, also applies at once on any pointer, as on iOS (DEC-4). So does the onset of its press color. A color that changes with a part that cross-fades follows that cross-fade, such as Switch's track with its thumb (component:Switch FR15). A touch press's release keeps its fade of 200 ms or less.
  • DR2a — A theme may reduce motion for everyone. A theme's reducedMotion: 'always' applies DR1–DR3 for every person, whatever their setting; 'system' follows each person's setting (spec:AST-108). No theme option loosens DR1–DR4.
  • DR3 — Fine-pointer presentations change at once. Under reduced motion, every other DR1 transition, when the primary pointer is not coarse, MUST complete immediately, with no animated property.
  • DR4 — No opt-out in core. A core component, its props, and its theme values offer no way to keep travel, scaling, springs, or a longer animation under reduced motion, and a component's own motion settings do not override DR1–DR3.

Content that moves with the person's own pointer or finger during a drag follows it as direct manipulation and is not a DR1 transition, and neither is the momentum that continues a throw (DR2). A transition a component starts when a touch drag is released, such as a swiped row sliding out or returning after a finger's swipe (spec:AST-057 FR5), cross-fades as DR2 says, because a finger started it; one a trackpad started follows DR2 on a coarse primary pointer and DR3 otherwise. Any other transition, such as one sheet handing off to another (component:BottomSheetSwitcher FR3), follows DR2 on a coarse primary pointer and DR3 otherwise.

Accessibility intent

Reduced motion removes movement, never information. The person still perceives that something appeared, left, or changed, and the result is the same as without the preference. Focus and announcements are unchanged.

Representative examples

  • With Reduce Motion on a phone, a menu opened by a tap fades in where it lands instead of sliding or scaling in.
  • With Reduce Motion on a phone, a bottom sheet presented by a tap fades in at its resting height instead of rising from the bottom edge.
  • With reduced motion and a mouse, a Tooltip, Popover, or Dialog appears and disappears in one frame.

Visual references

No normative assets are included.

Component contract links

  • spec:AST-057 FR5 implements DR2 and DR3 for a swiped row's slide out, spring back, and hold-out.
  • component:BottomSheetSwitcher FR3 and ORD1 implement DR2 and DR3 for a handoff between sheets.

Verification

Contract Verification Representative states Failure signal
DR1, DR2 Real-browser computed animations under reduced motion, coarse pointer Layer entrance and exit (Tooltip, Popover, menu); Dialog; modal BottomSheet; a presentation switch An animated transform, size, or position; a spring; a property other than opacity; over 200 ms; a change with no cross-fade
DR2 momentum Real-browser computed animations under reduced motion after a touch throw A flick that coasts and settles at an edge; a release that snaps to a detent, dismisses, or pages to a target A coast replaced by a cross-fade or stopped at release; a snap, dismissal, or page that travels instead of cross-fading
DR2 values Real-browser computed animations under reduced motion, coarse and fine pointer A determinate ProgressBar's fill and another continuous value changing in place A value that animates, cross-fades, or adds an element under reduced motion fails
DR2 colors Real-browser computed animations under reduced motion, coarse and fine pointer Button's press onset; ClickableCard's, SelectableCard's and Thumbnail's hover, border and selection colors A hover or selection color, or a press onset, that animates or cross-fades; a touch release fade over 200 ms
DR1, DR3 Real-browser computed animations under reduced motion, fine pointer The same components Any animated property, or a frame where the change is partly applied
DR4 Component prop and theme review plus the browser checks above A component with a motion prop or theme motion value set A prop or theme value that restores travel or a longer animation under reduced motion

Decision log

DEC-1 — Reduced motion matches iOS: cross-fade on touch, immediate otherwise

Reference: design:reduced-motion/DEC-1 Decider: cixzhang, 2026-10-24

People who turn on Reduce Motion on a touch device expect the platform's behavior, where changes cross-fade instead of moving, and a fade keeps the change noticeable without travel. With a fine pointer the change happens at once, so nothing moves and nothing waits. One rule for every core component, with no component able to keep its motion, means the preference is honored everywhere the same way.

Rejected: a per-component setting that keeps full motion under reduced motion.

DEC-2 — Momentum after a throw continues, as on iOS

Reference: design:reduced-motion/DEC-2 Decider: cixzhang, 2026-10-24

Under iOS Reduce Motion, a flicked scroll view keeps coasting and settles at its edge; only the transitions an app starts change to cross-fades. Matching that keeps a throw feeling like the person's own movement and keeps content from stopping dead at release, while snaps, dismissals, and paging, which a component starts, still cross-fade under DR2.

Rejected: cross-fading or stopping momentum at release.

DEC-3 — An in-place value change applies at once

Reference: design:reduced-motion/DEC-3 Decider: cixzhang, 2026-10-26

A progress fill's length and similar continuous values change where they are; cross-fading two lengths would need a second element and still show motion. Under reduced motion they take the new value at once on any pointer.

Rejected: a cross-fade between the old and new value on a touch screen.

DEC-4 — A color-only change of state applies at once

Reference: design:reduced-motion/DEC-4 Decider: cixzhang, 2026-11-03; companion clause per the owner's motion rule (2026-11-04)

A control's hover and selection colors, and the onset of its press color, change where they are and move nothing, so reduced motion has nothing to remove from them. Under reduced motion they take the new color at once on any pointer, as iOS does and as an in-place value does (DEC-3). A color that changes with a part that cross-fades, such as Switch's track with its thumb, follows that cross-fade, so the two never show different states. A touch press's release keeps its fade of 200 ms or less, which confirms the tap.

Rejected: a cross-fade of a hover or selection color on a touch screen.

Open questions

None.

Content boundary

This record defines what a person sees under reduced motion. It does not define durations or easing outside reduced motion, tokens, CSS properties, animation APIs, continuous status indicators such as a spinner, or audit checks.