Communitygithub.com

CharbelElBateh/personal-website

Appleのインターフェースデザインと流体のような物理モーションをWeb向けに翻訳。ジェスチャー駆動のUI、スプリングアニメーション、ドラッグ/スワイプ/シート操作、運動量と割り込み可能なトランジション、半透明マテリアルと奥行き、タイポグラフィ(オプティカルサイジング、トラッキング、リーディング)、モーション軽減、またはAppleスタイルのインターフェースの背後にあるデザイン基盤(フィードバック、空間的一貫性、抑制)を構築またはレビューする際に使用。

personal-website とは?

このスキルは、AppleのWWDCデザイン講演(主に「Designing Fluid Interfaces」WWDC 2018)から得られた知見を、Webプラットフォーム(CSS、Pointer Events、requestAnimationFrame、Motion/Framer Motionなどのスプリングライブラリ)向けに翻訳したものです。インターフェースが「生きている」と感じられるための核となる原則は、モーションが画面上の現在値から始まり、ユーザーの速度を継承し、運動量を前方に投影し、任意の瞬間に掴んで逆転できることです。スプリングは、本質的に割り込み可能で速度を認識するため、これらを自然に実現するツールです。このスキルは、レイテンシーを排除する「応答」、1:1の追跡による「直接操作」、アニメーションを途中で中断・方向転換できる「割り込み可能性」、物理的な動きを模倣する「スプリングアニメーション」、ドラッグからアニメーションへのシームレスな「速度ハンドオフ」、ジェスチャーの速度から停止位置を予測する「運動量投影」、対称的なパスを維持する「空間的一貫性」、ソフトな境界を実現する「ラバーバンディング」、半透明マテリアルと奥行き表現、マルチモーダルフィードバックなど、Appleのデザイン哲学をWebで実現するための具体的な実装パターンと概念を提供します。このスキルは、Appleスタイルの流体インターフェースを構築したいあらゆるフロントエンド開発者やAIエージェントユーザーに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/apple-design

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Apple Design

初回応答

このスキルが最初に特定の質問なしで呼び出された場合、以下のみを応答してください:

私は、流体でAppleスタイルのインターフェースをWeb上に構築するお手伝いをする準備ができています。私の知識はAppleのWWDCデザイントークから得られ、Web向けに翻訳されたものです。

ユーザーが質問をするまで、他の情報は提供しないでください。

Appleがどのようにインターフェースを構築し、それがコンピューターの延長ではなく、あなた自身の延長のように感じられるようにしているか。この知識は、AppleのWWDCデザイントーク(主に Designing Fluid Interfaces WWDC 2018)から得られ、Webプラットフォーム(CSS、Pointer Events、requestAnimationFrame、Motion/Framer Motionのようなスプリングライブラリ)に蒸留・翻訳されたものです。

一貫したテーマ:モーションが画面上の現在値から始まり、ユーザーの速度を継承し、運動量を前方に投影し、任意の瞬間に掴んで逆転できるとき、インターフェースは生きているように感じられます。 スプリングは、これらすべてを自然にするためのツールです。なぜなら、それらは本質的に割り込み可能で速度を認識するからです。

核となる考え

「インターフェースを私たちの考え方や動き方に合わせると、魔法のようなことが起こります。それはコンピューターのように感じるのをやめ、私たちのシームレスな延長のように感じられるのです。」

インターフェースが流体的であるとは、物理世界のように振る舞うことです。つまり、物事が瞬時に応答し、継続的に動き、運動量を運び、境界で抵抗し、動きの途中で方向転換できることです。以下のすべては、それに近づくための方法です。

Appleはデザインを4つの人間のニーズに応えるものとして位置づけています:安全性/予測可能性、理解、達成、そして喜び。 ここでのすべてのルールは、それらのいずれかに貢献します。

1. 応答 — レイテンシーをなくす

遅延が現れた瞬間、直接性の感覚は「崖から落ちる」ように失われます。応答は、他のすべてが構築される基盤です。

  • ポインターダウン時に応答し、リリース時ではない。 ボタンが押された瞬間にハイライトします。click/タッチアップまで待ってからフィードバックを表示するのは、死んでいるように感じられます。
  • あらゆるレイテンシーに警戒すること。 デバウンス、人為的なタイマー、トランジションの待機、約300msのタップ遅延を監査します。入力パス上で必須でないものはすべて後退です。
  • フィードバックは相互作用中継続的であるべきで、最後だけではない。 ドラッグ、スライダー、またはドロワーの場合、UIをポインターと1:1で全体を通して更新します。ジェスチャーが完了したときにのみアニメーションさせないでください。
/* フィードバックは押下時に存在し、瞬時である */
.button:active {
  transform: scale(0.97);
  transition: transform 100ms ease-out;
}

2. 直接操作 — 1:1追跡

「タッチとコンテンツは一緒に動くべきである。」

ユーザーが何かをドラッグするとき、それは指に接着されていなければならず、掴んだ位置からのオフセットを尊重しなければなりません。掴んだ瞬間に要素の中央にスナップすると、錯覚は即座に壊れます。

  • Pointer EventsをsetPointerCaptureと共に使用して、ポインターが要素の境界を離れても追跡が継続されるようにします。
  • 現在のポイントだけでなく、短い速度/位置履歴(最後のいくつかのpointermoveイベント)を追跡します。リリース時に速度が必要になります。
el.addEventListener('pointerdown', (e) => {
  el.setPointerCapture(e.pointerId);
  const grabOffset = e.clientY - el.getBoundingClientRect().top; // 掴んだ位置を尊重
  // ...位置+タイムスタンプ履歴を速度のために追跡
});

3. 割り込み可能性 — 最も重要な原則

「思考とジェスチャーは並行して発生する。」

すべてのアニメーションは、いつでも割り込み可能で方向転換可能でなければなりません。ユーザーは、アニメーションが終了するのを待つことなく、動いている要素を途中で掴んで逆転できなければなりません。閉じようとしているモーダルをユーザーが再び掴んだ場合、先に閉じてから再度開くのではなく、指に追従するべきです。

  • トランジション中に入力をロックアウトしないこと。
  • 常にプレゼンテーション(現在の)値からアニメーションさせ、ターゲット値からではない。 割り込み時には、要素の画面上のライブトランスフォームを読み取り、そこから新しいアニメーションを開始します。論理的な/ターゲット値から開始すると、目に見えるジャンプが発生します。
  • ジェスチャー駆動のものにはCSSトランジションと@keyframesを避ける — それらは途中でスムーズに掴んで逆転することができません。スプリングはデフォルトで現在の値からアニメーションするため、割り込みに正確に必要なものです。
  • ジェスチャーが逆転するときは、速度をブレンドし、ハードカットしない。 逆転ポイントで一つのアニメーションを別のものに置き換えると、速度の不連続性、「レンガの壁」が発生します。再ターゲット時に速度を保持するスプリングライブラリはそれを回避します。(これはiOSの加算アニメーションがネイティブに行うことです。Web上では、現在の速度から再ターゲットするスプリングライブラリを選択してください。)
  • 2Dモーションを独立したXとYのスプリングに分解する。 2D距離に単一のスプリングを使用すると、XとYの速度が異なる場合に同期がずれます。

4. アニメーションよりも動作 — スプリングを使う

「アニメーションを、インターフェースによって規定されたものではなく、あなたとオブジェクトの間の会話として考えてください。」

事前にスクリプト化された固定時間のアニメーションは、新しい入力に応答できません。スプリングはそれができます。新しい入力はターゲットを変更するだけで、モーションは継続的に保たれます。ユーザーが触れる可能性のあるものにはスプリングを使用してください。

Appleは意図的に物理の三つ組(質量/剛性/減衰)を、デザイナーに優しい2つのパラメータに置き換えました。これらで考えてください:

  • 減衰比 — オーバーシュートを制御します。1.0 = 臨界減衰、バウンスなし、スムーズな沈静。< 1.0 = オーバーシュートして振動します。低いほどバウンドします。
  • 応答 — 値がターゲットに到達する速さ(秒単位)。低いほどスナッピーです。これは「期間」ではありません — スプリングには固定の期間はありません。その沈静時間はパラメータから創発します。

デフォルト:

  • ほとんどのUIは減衰1.0(臨界減衰)から始めます — 優雅で気を散らしません。
  • **バウンス(減衰〜0.8)**は、ジェスチャー自体が運動量を持っていた場合のみ(フリック、スロー、ドラッグリリース)追加します。単にフェードインしたメニューでのオーバーシュートは間違っているように感じられますが、フリックしたカードでのオーバーシュートは正しく感じられます。

Appleが実際に使用する値:

インタラクション減衰応答
移動/再配置(例:PiP)1.00.4
回転0.80.4
ドロワー/シート0.80.3

Webマッピング(Motion / Framer Motion): bounce + duration スプリングAPIは、Appleの減衰+応答に密接にマッピングされます。安全なハウススタイルは、デフォルトでdamping: 1.0のスプリングをあらゆる場所に使用し、運動量駆動の物理的インタラクションのためにバウンスを予約することです。

import { animate } from 'motion';

// 臨界減衰デフォルト(オーバーシュートなし)
animate(el, { y: 0 }, { type: 'spring', bounce: 0, duration: 0.4 });

// 運動量インタラクション — 少しバウンス、ただしフリックが先行した場合のみ
animate(el, { y: target }, { type: 'spring', bounce: 0.2, duration: 0.4 });

5. 速度ハンドオフ — ドラッグとアニメーションの間の継ぎ目

ジェスチャーが終了したとき、アニメーションは指の正確な速度で継続しなければなりません。そうすることで、ドラッグとアニメーションの間に目に見える継ぎ目がなくなります。これは、「流体的」と「普通」を最も大きく分ける詳細です。

ポインターのリリース速度をスプリングの初期速度として渡します。一部のスプリングAPIは相対速度を必要とします — 残りのターゲットまでの距離で正規化します:

relativeVelocity = gestureVelocity / (targetValue − currentValue)

例:要素がy=50、ターゲットがy=150(残り100px)、指が50px/sで移動 → 初期スプリング速度 = 50 / 100 = 0.5。Framer Motion / Motionは絶対px/sの速度を直接受け取るため(velocityオプション)、通常は生の値を渡します。

6. 運動量投影 — ジェスチャーが向かっている場所にアニメーションさせる

「小さな入力を受け取り、大きな出力を生み出せ。」

リリースポイントから最も近い境界にスナップしないでください。速度を使用して停止位置を投影します — スクロールの減速とまったく同じように — そして、その投影されたポイントに最も近いターゲットにスナップします。これが、フリックが要素を投げているように感じさせるものです。

Appleの正確な投影関数(Designing Fluid Interfacesのサンプルコードより):

// decelerationRate ≈ 0.998 通常のスクロール感覚; 0.99 よりスナッピー
function project(initialVelocity /* px/s */, decelerationRate = 0.998) {
  return (initialVelocity / 1000) * decelerationRate / (1 - decelerationRate);
}

const projectedEndpoint = currentPosition + project(releaseVelocity);
const target = nearestSnapPoint(projectedEndpoint);   // 投影からターゲットを選択
animateSpringTo(target, { velocity: releaseVelocity }); // 次に速度をハンドオフ(§5)

注:物理の教科書にあるv²/(2·decel)は、Appleが出荷しているものではありません — 上記の指数減衰形式を使用してください。これは優れたボトムシートやカルーセル(Vaul、Embla)での標準的な動作です。

7. 空間的一貫性 — 対称的なパス、固定された原点

「何かがある方法で消えたなら、私たちはそれが来た場所から現れることを期待する。」

  • 出入りは同じパスに沿って行う。 右からスライドインするパネルは、右に dismissing しなければなりません。右から入って下から出るのは、断絶していて混乱を招きます。
  • インタラクションをその発生源に固定する。 メニュー、ポップオーバー、またはシートは、それをトリガーした要素から発生するべきです — transform-originをトリガーに設定して、ボタンとコンテンツの間の空間的関係が明らかになるようにします。(これは、ポップオーバーが中央ではなくトリガーからスケーリングするという、同じ原点認識のポイントです。)
  • 可逆的なトランジションでイージングをミラーリングし、出力パスが戻りのパスと一致するようにします(2つの方向に逆の3次ベジェ制御点を使用します)。

8. ジェスチャーの方向をほのめかす

人間は軌跡から最終状態を予測します。中間のモーションは、物事がどこに向かっているかを示すべきです — Control Centerのモジュールは「あなたの指に向かって上と外に成長します。」中間フレームを結果に向けてポイントさせ、盲目的にそれに補間するのではなく。

9. ラバーバンディング — ソフトな境界

境界では、ハードに停止するのではなく、徐々に抵抗します。ハードストップは「フリーズした」と読まれます。継続的な抵抗は「応答性はあるが、ここにはもう何もない」と読まれます。ユーザーが境界を越えてドラッグするほど増加する減衰を適用します。

// 境界を超えるほど、要素は追従しなくなる — 実際のものは停止する前に減速する
function rubberband(overshoot, dimension, constant = 0.55) {
  return (overshoot * dimension * constant) / (dimension + constant * Math.abs(overshoot));
}

10. ジェスチャーデザインの詳細(「感触」チェックリスト)

  • タップ: タッチダウン時にハイライト(瞬時)、タッチアップ時にコミット。ターゲットの周りに約10pxのヒステリシス/ヒットパディングを追加し、ドラッグアウェイとバックによるキャンセルを許可します。
  • ドラッグ/スワイプ: 方向にコミットする前に小さな移動閾値(ヒステリシス、約10px)を要求し、その後1:1で追跡します。
  • 最初の動きからすべての可能性のあるジェスチャーを並列に検出し、意図が明確になり次第、負けたものを確信を持ってキャンセルします。最終状態のみを報告する認識子(swipeleftタイプのイベント)は避けてください — それらはフィードバックに必要な継続的な追跡を捨ててしまいます。
  • 曖昧性解消の遅延を最小限に抑える。 ダブルタップ検出は不可避的にシングルタップを遅らせます。ダブルタップが実際に存在する場合にのみ、そのコストを支払ってください。

11. フレームレベルのスムーズさ

スムーズさは、フレームレートだけでなく、フレームの内容に関するものです。

  • フレームごとの位置変化を知覚閾値以下に保ち、ストロボ効果(ちらつき)を避けます。
  • 非常に高速なモーションの場合、微妙なモーションブラー/ストレッチが速度をエンコードし、ハードなシャープな軌跡よりも読みやすくなります。
  • requestAnimationFrameはWebのディスプレイ同期クロックです(AppleはCADisplayLinkを使用)。コンポジターに優しいプロパティ — transformとopacity — のみをアニメーションさせ、モーションが差し迫っている場所にはwill-changeをヒントとして使用します。

12. マテリアルと奥行き — 半透明が階層を伝える

Appleは、フォーカスを奪うことなく構造をもたらす浮遊する機能レイヤーとして半透明マテリアルを使用します。Web上では、backdrop-filterで近似します。

  • ナビゲーション/ツールバー/シートを半透明レイヤーとして構築する(backdrop-filter: blur() + 半透明の背景)、コンテンツはその下をスクロールします — 固定された帯を消費する不透明なバーではありません。
  • マテリアルの重みは階層をエンコードする: より暗く/より重いマテリアルは構造的な領域(サイドバー)を分離します。より軽いマテリアルはインタラクティブな要素(ボタン)に注意を引きます。軽い半透明のサーフェスを別の上に重ねないでください — 可読性が崩壊します。
  • より大きなサーフェスはより厚く見えるべき: 小さなチップよりも強いぼかしと深い影。コンテキストを認識した影を検討してください — ビジー/テキストコンテンツの上ではより重く、分離のために。プレーンな背景の上ではより軽く。
  • ディミングでフォーカスし、分離してフローを維持する。 モーダルタスクは、サーフェスをディミングスクリムと組み合わせ、背景を押し戻します。並行する非ブロッキングパネルは、スクリムなしで半透明とオフセットを使用し、フローが中断されないようにします。スタックされたシートでは、各親レイヤーを徐々にディミングし、押し戻します。
  • ビブランシーは、変化する背景の上でもテキストの可読性を維持する。 ぼかし/半透明のサーフェスの上では、フラットなグレーのテキストを使用しないでください — より高いコントラスト、わずかに太いウェイト、および小さな文字間隔の増加を使用してください。色は半透明の前景ではなく、ソリッドなレイヤーに配置してください。
  • スクロールエッジ効果、ハードな区切り線ではない。 スティッキーヘッダーの下の1pxの境界線の代わりに、浮動UIが実際にコンテンツと重なる場所にのみ、コンテンツが浮動クロームに接する場所に小さなぼかし/グラデーションマスクをフェードさせます。
  • フェードだけでなく、マテリアライズする。 ガラス/ぼかしサーフェスの場合、出入り時にぼかし半径とスケールを一緒にアニメーションさせ、サーフェスが単なる不透明度フェードではなく、到着する実際のマテリアルとして読まれるようにします。
.toolbar {
  background: rgba(255, 255, 255, 0.6);
  backdrop-filter: blur(20px) saturate(180%);
  border-top: 1px solid rgba(255, 255, 255, 0.4); /* 明るい上端 = マテリアルに当たる光 */
}

13. マルチモーダルフィードバック — モーション+サウンド+ハプティクス

感覚を組み合わせるための3つのルール(Designing Audio-Haptic Experiencesより):

  1. 因果関係 — 何がフィードバックを引き起こしたかが明らかでなければなりません。実際の因果イベント(トグルが反転する、アイテムが所定の位置にスナップする)でトリガーし、その特性をアクションの物理性に一致させます。
  2. 調和 — ビジュアル、サウンド、ハプティクスは同じフレームで発火しなければなりません。それらの間のレイテンシーは錯覚を破壊します。アニメーションを遅らせてサウンドに同期させないでください。
  3. 連続性 — フィードバックのシーケンスを設計し、孤立したイベントとしてではありません。スワイプで項目をアーカイブする場合:抵抗の増加(ドラッグ中)→ しきい値を超えたときの軽いタップ → スナップインのサウンド。

14. モーション軽減

「流体インターフェースは障壁を減らすことに関するものであり、すべての人を同じ障壁にさらすことではありません。」

  • CSSメディアクエリ prefers-reduced-motion をチェックします。reduce の場合、視覚的なモーションを除去するか減らします。スケールアップには即時スナップを使用します。パララックス、背景アニメーション、トランジションアニメーションをオフにします。スプリングの時間スケールを短くします。
  • しかし、完全にすべてのモーションを除去しないでください — わずかな不透明度のフェードは、手術的な正確さのために有用なままです。障壁となる動きを取り除きます。
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;

function animateSpringTo(target, opts = {}) {
  if (prefersReduced) {
    Object.assign(el.style, { transform: `translateY(${target}px)`, transition: 'none' });
    return;
  }
  // ...通常のスプリング
}

究極のチェックリスト

以下の質問のいずれかに「いいえ」と答えた場合、インターフェースはAppleの意味で本当に流体的ではありません:

  • ユーザーが動いている要素を掴んだときに、それが中断なく指に追従しますか?
  • インタラクションの開始(ポインターダウン)と終了(リリース)にフィードバックがありますか?
  • ドラッグが終了したとき、アニメーションは指の正確な速度で続き、継ぎ目はありませんか?
  • フリックは、リリースポイントではなく、速度に基づいて論理的な停止位置にスナップしますか?
  • 要素は、現在の画面上の値からアニメーションし、論理的な/ターゲット値からではありませんか?
  • トランジションはロックアウトされますか(ユーザーは閉じているドロワーを再び開くためにタップできますか)?
  • 境界の抵抗は徐々に増加しますか(ラバーバンディング)、それとも突然停止しますか?
  • モーション軽減が有効な場合、UIはオフにされたアニメーションで応答性を維持しますか?

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

関連スキル