apple-design

Implements Apple-style fluid interface design with spring animations, gestures, and translucency for the web.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill apple-design-alex-jordan547
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-design
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/2026-09-10/apple-design
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill apple-design-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web interfaces often feel stiff and disconnected because animations are pre-scripted, non-interruptible, and ignore gesture velocity. This Skill translates Apple's fluid interface design principles from WWDC talks into concrete web techniques using CSS, Pointer Events, and spring libraries like Motion and Framer Motion. ## Core Features & Use Cases - Gesture-Driven Motion: Implement 1:1 drag tracking with Pointer Events, velocity handoff to springs, momentum projection, and rubber-banding at boundaries. - Spring Animation Guidance: Apply Apple's damping ratio and response parameters instead of fixed-duration animations, with concrete values for drawers, sheets, and repositioning. - Materials, Typography & Accessibility: Build translucent layers with backdrop-filter, size-specific type tracking and leading, and reduced-motion/reduced-transparency fallbacks. - Use Case: When building a bottom sheet that users can drag, flick, and re-grab mid-animation, use this Skill to wire pointer tracking, project the flick landing point, and hand off release velocity to a spring so the motion feels continuous. ## Quick Start Use the apple-design skill to review my bottom sheet component and make its drag and dismiss animations feel fluid and interruptible.

Frequently Asked Questions about apple-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make web animations interruptible like iOS?

Always animate from the element's current on-screen presentation value, never the target value, and never lock input during transitions. Use spring animations instead of CSS transitions or keyframes, since springs re-target from the current value and velocity by default.

How do I implement a draggable bottom sheet with momentum on the web?

Track the pointer with Pointer Events and setPointerCapture, record recent move events for velocity, then project the resting position using Apple's exponential decay formula and snap to the nearest target. Hand the release velocity to a spring so the drag-to-animation transition has no visible seam.

What spring parameters should I use with Framer Motion or Motion?

Apple uses damping ratio and response instead of duration. Default to damping 1.0 (no overshoot) with response 0.3-0.4 seconds; use damping around 0.8 only for momentum-driven interactions like flicks. Motion's bounce and duration spring API maps closely to these values.

Why do CSS transitions feel wrong for gesture-driven UI?

CSS transitions and keyframes are pre-scripted with fixed durations, so they cannot be grabbed and reversed mid-flight without a visible jump or velocity discontinuity. Springs animate from the current value and carry velocity through re-targeting, which is what interruption requires.

How do I handle reduced motion for spring animations?

Respond to the prefers-reduced-motion media query by replacing slides, springs, and parallax with short opacity cross-fades or static transitions. Also handle prefers-reduced-transparency by making translucent surfaces more solid, and prefers-contrast by adding defined borders.

How do I recreate iOS translucent blur materials in CSS?

Use backdrop-filter with blur and saturate plus a semi-transparent background, letting content scroll underneath the layer. Match material weight to hierarchy, avoid stacking light translucent surfaces, and animate blur radius with scale on enter and exit so the surface reads as a real material.