# Motion

Page: /docs/foundations/motion

{/* Figma: Meridian → Motion (page 7:96). */}

Motion explains a change. Pathfinder’s springs, durations and easings, plus two Meridian curves for marketing pages: pop for things appearing and glide for cursor travel. Things close faster than they open; only success bounces.

## Principles [#principles]

Every transition is checked against these.

1. **Motion explains change.** Things arrive from where they came from: a menu from its trigger, a row from its list.
2. **Change the element.** A state change happens on the element itself. Nothing blinks out and back.
3. **Open with weight, close fast.** Opening uses a spring; closing takes about 70% of the time and never bounces.
4. **Respond within 100ms.** Press feedback starts on pointer down and never waits on the network.
5. **Bounce is earned.** Only success bounces. Data, errors and anything to be read never bounce.

## Springs [#springs]

The default for anything that moves. Each spring is a visual duration and a bounce.

| Token | Duration · bounce | Use |
| --- | --- | --- |
| spring/snappy | 0.2s · 0 | Press, switches, checkboxes, menus opening. Must feel instant. |
| spring/smooth | 0.3s · 0 | The app-wide default. Sliding indicators, expanding content, size and layout changes, dialogs, list rows. |
| spring/release | 0.3s · 0.15 | Motion a gesture started: a drag or sheet settling after release, a flick, a rubber band springing back. Carries the release velocity. |
| spring/expressive | 0.4s · 0.25 | Moments of success only (a check landing). Never on expand, data or errors. |

`spring/release` and a non-bouncing `smooth` come with Pathfinder 0.3; the pinned 0.2.0 still has `smooth` at bounce 0.15.

## Duration [#duration]

For CSS transitions, exits and anything that cannot run on a spring. Nothing goes above 300ms except sheets.

<Durations />

## Easing [#easing]

Curves for duration-based transitions. pop and glide are Meridian (`--ease-pop`, `--ease-glide`); the rest are Pathfinder’s `--pf-easing-*`.

<Easings />

## Recipes [#recipes]

Every animation is one of these. If none fits, add a recipe here first.

| Recipe | Motion | Tokens | Used by | Source |
| --- | --- | --- | --- | --- |
| Press | Scale to 0.97 on pointer down, back on release. Keyboard never scales. | spring/snappy | Button, IconButton, Pill | Pathfinder |
| Hover | Colour only. No movement, no scale. | duration/instant · easing/standard | Every control | Pathfinder |
| Open from the trigger | Opacity 0 to 1, scale 0.96 to 1 from the trigger. Closes in 120ms. | spring/snappy · menu exit 120 | Select, Popover, menus | Pathfinder |
| Panel and dialog | Fade and rise 8. Exit is a fade only. | spring/smooth · duration/fast | Dialog, panels | Pathfinder |
| Sheet | Slides in 500, out 400. | easing/sheet · duration/deliberate | Mobile nav drawer | Pathfinder |
| Row in | Rows rise 8 and fade in, 40 apart. | easing/out · duration/slow | Tables in product shots | Meridian |
| Badge pop | Scale 0.8 to 1 with a small overshoot. | easing/pop · 360 | Status pills, chips, nodes in shots | Meridian |
| Cursor glide | The fake cursor travels between targets. | easing/glide · 850 | Product-shot animations | Meridian |
| Success | A check lands with a bounce. | spring/expressive | Button done, form sent | Pathfinder |

## Best practices [#best-practices]

- Pick a recipe; never invent a curve.
- Reduced motion: no movement, fades only.
- Source: Pathfinder Motion. Meridian adds easing/pop, easing/glide and the Row in, Badge pop and Cursor glide recipes.
