Apple Motion Engineering
How Apple makes software stop feeling like disconnected frames and start feeling like one calm, continuous physical world — responsive on frame 1, silky and unhurried into rest, completely interruptible mid-flight, and spatially coherent from click to dismiss.
Synthesized from Apple WWDC (Designing Fluid Interfaces 2018, Animate with springs 2023, Enhance UI animations 2024), Janum Trivedi's Wave engine, Rauno Freiberg (Invisible Details), Jakub Krehel, Dan Saffer (Microinteractions), Emil Kowalski (apple-design, animate, choreograph, gestures, review-animations), fluid-design, and production Jetpack Compose motion implementations. Purely focused on motion, timing, geometry morphs, gestures, and haptics.
Why Apple Motion Feels Unhurried, Soft & Cohesive
- Instant Lift-Off, Long Feather Settle: Apple curves (
cubic-bezier(0.32, 0.72, 0, 1)) and perceptual springs travel 70–80% of the distance in the first ~30% of time, then glide delicately down to sub-pixel velocity over the remaining ~70%. Your eye feels zero lag on touch yet watches an unhurried, peaceful landing. - Physics Over Fixed Timers (
C^1Continuity): Springs integrate live position and instantaneous velocity. When a user catches a closing sheet or reverses a navigation push mid-flight, motion redirects cleanly without snapping or restarting from zero. - Trigger Decides Bounce ("Read the Trigger, Not the Component Name"): Tap-opened drawers, modals, and screens take zero bounce (
dampingRatio = 0.88–1.0,bounce = 0.0) — nothing threw them. Visible overshoot (damping ≈ 0.80,bounce = 0.15–0.20) is earned only by physical momentum (a flick/throw) or small tactile accents. - Spatial Traceability (Cause-and-Effect Continuity): Panels never teleport out of thin air. Cards expand from their clicked
Rectand shrink smoothly back into it on back/dismiss; popovers grow out of their trigger corner; underlying tabs stay mounted at depth (0.94..1.0) so peeking never flashes blank. - Single Progress Source of Truth: Foreground translation, corner radius morph (
cardRadius -> 0dp -> 30dp peel), underlying Z-depth scale, and backdrop scrim are derived from one normalized scalar so layers never drift out of sync during partial gestures. - Continuous Corners & Concentricity: Nested radii share a geometric center ($R_{\text{inner}} = \max(R_{\text{min}}, R_{\text{outer}} - \text{padding})$) and animate continuously alongside bounds (
~22.37%app icon squircle proportion $\rightarrow 0 \rightarrow$ hardware bezel). - Compact Shared Vocabulary: Every component pulls from one shared 3–5 token motion system rather than ad-hoc timers, making tabs, cards, sheets, buttons, and typography settle in unified rhythm.
Pre-Flight Gate: Should This Animate & How Much?
Before writing animation code, check frequency tier and purpose:
| Trigger Frequency | Decision | Target Behavior |
|---|---|---|
| 100+ times/day (keyboard shortcuts, command palette toggle, rapid typing) | 0ms Instant | Zero transition delay; velocity > ornament. |
| Tens of times/day (tab switches, hover tooltips, list navigation) | Calm Micro-Motion | 120–240ms crisp ease-out or short in-place cross-dissolve (Tab). Zero bounce. |
| Occasional (card opens, push details, sheets, modals, pull-to-dismiss) | Full Spatial Continuity | Hero bounds morph, depth parallax (0.94), 360–460ms feather tail. |
| Rare / First-Time (payment success checkmark, onboarding milestone) | Signature Delight | Earned overshoot (bounce ≈ 0.25–0.30), choreographed accent sequence. |
Every animation must serve at least one real purpose: Spatial Continuity, Immediate Feedback, State Indication, Reflow Smoothing, or Deliberate Delight. Never animate layout properties when visuals suffice.
Canonical Motion Tokens & Core Equations
1. Canonical Apple Cubic-Bezier Curves
| Token | (x1, y1, x2, y2) | Default Budget | Primary Use |
|---|---|---|---|
AppleSheet | (0.32, 0.72, 0.0, 1.0) | 420–500ms (full sheets/screens) | Steep launch + ultra-long soft deceleration tail (260ms for predictive back finish). |
AppleSilk | (0.28, 0.11, 0.14, 1.0) | 200–240ms (micro) / 360–380ms (content) | Warm, unhurried cross-dissolves, opacity/content transitions, tab switches. |
AppleEaseOut | (0.23, 1.0, 0.32, 1.0) | 150–250ms | Strong UI ease-out for floating popovers, menus, tooltips (125ms), hover/press exits. |
AppleInOut | (0.77, 0.0, 0.175, 1.0) | 250–360ms | On-screen repositioning of persistent elements without entering/exiting. |
AppleEase | (0.25, 0.1, 0.25, 1.0) | 150–200ms (400ms toasts) | Quiet fades and subtle background color shifts. |
Hard Rule: Never use
ease-inon UI entrances or exits (starts slow at frame 1, causing perceived input lag). Reservelinearexclusively for time-progress gauges (hold-to-confirm rings, continuous marquees). Never loop a spring (repeatForever) — springs slow near seams and stutter.
2. Perceptual Spring Presets & Cross-Platform Equivalents ($m = 1$)
| Role | SwiftUI (duration, bounce) | Compose (dampingRatio, stiffness) | Physics c | When to Use |
|---|---|---|---|---|
Calm Structural (.smooth) | (0.50s, 0.00) | (0.92f, 210f) (gentle) | 25.1–26.7 | Background parallax, large calm state transitions. |
| Screen Navigation | (0.41s, 0.10) | (0.90f, 240f) | 27.9 | Stack push/pop, predictive-back cancel recovery, hero return. |
| Fluid Content / Hero | (0.39s, 0.12) | (0.88f, 260f) | 28.4 | Card-to-screen hero morphs, App Store card expand (0.42, 0.82). |
| Layout Reflow | (0.38s, 0.12) | (0.88f, 270f) | 28.9 | Sliding segmented pills, animateContentSize, accordions. |
Tactile Control (.snappy) | (0.50s / 0.33s, 0.15) | (0.80f, 360f) | 21.4 / 32.3 | Responsive toggles, switches, snap-back after minor drag. |
| Press Down | (0.31s, 0.14) | (0.86f, 420f) | 35.3 | Instant pointerdown / ACTION_DOWN compression (scale ~0.97). |
| Press Release / Pop | (0.36s, 0.32) | (0.68f, 300f) | 23.6 | Touch-up spring rebound; micro action pills (0.72f, 380f). |
| Momentum Flick Release | (0.30s, 0.20) | (0.80f–0.85f, 360f) | 33.5 | Flicked drawer/sheet/PiP detent snap carrying gesture velocity. |
3. Essential Physics Equations
- SwiftUI
bounce$\leftrightarrow$dampingRatio($\zeta$): $\zeta = 1 - b$ for $b \ge 0$; $\zeta = 1 / (1 + b)$ for $b < 0$. - Perceptual
response$R$ (sec) $\rightarrow$ Compose/Motion(stiffness k, damping c): $$k = \left(\frac{2\pi}{R}\right)^2 m, \qquad c = \frac{4\pi \cdot \zeta \cdot m}{R}$$ - Momentum Projection (WWDC18 — project flick before choosing snap detent): $$\text{projectedDelta}(v_0, d) = \frac{v_0}{1000} \cdot \frac{d}{1 - d} \qquad (d = 0.998\text{ scroll},\ 0.990\text{ crisp snap})$$
- Rubber-Banding Past Boundaries: $$\text{offset}(x', D) = \frac{x' \cdot D \cdot 0.55}{D + 0.55 \cdot |x'|}$$
- Relative Spring Velocity (for UIKit / unit-normalized animators): $$v_{\text{rel}} = \frac{v_{\text{gesture}}}{\text{targetValue} - \text{currentValue}}$$
Decision Matrix: Which Pattern Do I Build?
| Scenario | Recommended Apple Architecture | Detailed Reference |
|---|---|---|
| Opening detail screen from a clicked card/tile | Hero Bounds Morph (HeroBoundsRegistry + scale/center translation + continuous corners + hide source slot during flight) or SwiftUI .matchedTransitionSource + .navigationTransition(.zoom) | 02-navigation-and-hero-morph.md |
| Multi-tab bottom bar + stacked detail pages | Layer 0 SaveableStateProvider zero-remount host (tabTransform cross-dissolve) + Layer 1 depth parallax (0.94..1.0) & optical scrim | 02-navigation-and-hero-morph.md |
| Android 14+ swipe back / iOS edge peel | PredictiveBackHandler with quadratic softening c = 0.7r + 0.3*(1-(1-r)^2), vertical touchY tilt, 0dp -> 30dp corner bevel morph, navigationSpring cancel | 02-navigation-and-hero-morph.md, 04-jetpack-compose-cookbook.md |
| Bottom sheet / media swipe-to-dismiss / PiP throw | 1:1 snapTo drag + 0.55 rubber-band + projectOffset detent choice + hand release VelocityTracker straight to spring (2D independent X/Y for PiP) | 03-gestures-scroll-and-haptics.md |
| Dropdowns, menus, tooltips, modals | Anchor transformOrigin at clicked trigger (TopEnd / var(--transform-origin)), scale 0.94 -> 1.0 + opacity over 160–220ms AppleEaseOut (never scale(0)) | 02-navigation-and-hero-morph.md, 05-swiftui-web-crossplatform.md |
| Compact pill expanding both width & height | Asymmetric Dynamic Island morph: container leads (0.35s, 0.85), fast exit (130ms + scale 0.82 + tiny blur), delayed soft enter (popLayout) | 02-navigation-and-hero-morph.md, 03-gestures-scroll-and-haptics.md |
| Scroll-linked header collapse / parallax / lists | Read scroll inside GPU draw phase (graphicsLayer / visualEffect) — zero recomposition; coarsen chrome toggles to discrete threshold crossings | 03-gestures-scroll-and-haptics.md |
| Buttons, sliders, toggles, wheel pickers, numbers | Instant pointerdown scale (0.965) + haptic tick on threshold crossings + tabular numeric odometer slides | 03-gestures-scroll-and-haptics.md, 04-jetpack-compose-cookbook.md |
| Reviewing/debugging sluggish, jittery, or bouncy UI | Check against the 12 Deadly Sins + Symptom -> Root Cause matrix + automated grep/rg checks | 06-audit-and-anti-patterns.md |
Reference Documentation Map (Load On Demand)
Read the specific reference file(s) matching the current engineering task:
- Curves, Spring Math, Velocity & Concentricity: references/01-physics-and-curves.md
- Hero Morph, Layer Depth Parallax, Predictive Back & Signature Apple Transitions: references/02-navigation-and-hero-morph.md
- Latency Elimination, Interruptibility, Scroll Choreography, Stagger & Haptics: references/03-gestures-scroll-and-haptics.md
- Production Jetpack Compose Cookbook (
AppMotion,HeroBoundsRegistry,PredictiveBackHandler, Modifiers): references/04-jetpack-compose-cookbook.md - Cross-Platform Implementations (SwiftUI, UIKit/
Wave, Web/React/Motion, Flutter): references/05-swiftui-web-crossplatform.md - Audit Checklist, The 12 Deadly Sins, Symptom Table & Static Grep Checks: references/06-audit-and-anti-patterns.md
Standard Implementation & Polish Workflow
- Consolidate Tokens First: Before touching components, verify whether the repo already defines curves/springs (
AppMotion.kt, SwiftAnimationextension, CSS tokens). Extend them — never create competing parallel animation tokens. - Pass the Frequency & Purpose Check: Confirm whether the interaction should be instant (
0msfor 100+/day shortcuts), calm (Tab/Micro), or full spatial continuity (Hero/Sheet). - Derive Multi-Layer Motion From One Scalar: Bind container bounds/translation, corner radii progression, depth parallax scale (
0.94..1.0), and scrim opacity to a single normalized progressAnimatable/ motion value so interruption stays rock-solid. - Keep Compositor-Only at 120Hz: Translate/scale/rotate/fade inside
graphicsLayer/visualEffect/ CSStransform&opacity. Coarsen raw scroll offsets into boolean threshold triggers. - Pair Physical Touch + Accessibility: Wire
pointerdowncompression + single threshold-crossing haptics, and verify a Reduce Motion branch (replace travel/zoom with150mscrossfades while keeping 1:1 finger tracking). - Audit Before Shipping: Walk through the 10-Point Checklist and run the platform
rg/grepverification scans in 06-audit-and-anti-patterns.md.