Communitygithub.com

CharbelElBateh/personal-website

ExpoおよびReact Nativeアプリケーションにおけるアニメーション構築のためのスキル。Reanimated、Gesture Handler、Expo Router、expo-haptics を用いて、実機でのフィーリングを重視したモーションを実装します。

personal-website とは?

このスキルは、React Native(特にExpo)向けのアニメーション構築に特化したプロフェッショナルなガイドです。Emil Kowalskiのアニメーション哲学を基盤とし、シミュレーターではなく実機での厳しいレビューに耐える実装を提供します。主な対象は、モバイルならではの制約(ホバーがない、UIスレッドとJSスレッドの分離、ジェスチャー主体の操作)を理解し、Reanimated 4(ワークレット)を使用したUIスレッド上でのアニメーション、Gesture Handlerによるジェスチャー、Expo Routerによる画面遷移・シート・ネイティブタブ、expo-hapticsによるハプティクスを組み合わせた実装です。また、LottieやSkiaなどのツール選択基準、CSSトランジション/アニメーションと共有値の使い分け、スプリングとタイミングの設定パラメータ、アクセシビリティ対応(reduced motion)、パフォーマンス最適化(レイアウトパスの回避、スレッド管理)など、実践的な知識を体系的に提供します。

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

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

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

ドキュメント

Expoでのアニメーション構築

初回応答

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

実機で正しく感じられるExpoとReact Nativeのアニメーションを構築する準備ができています。私の知識はEmil Kowalskiのアニメーション哲学に基づいています。

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

React Nativeのための構築スキルです。モーションのリクエストを、実機での厳しいレビューに耐える実装に変換します。シミュレーターでも、開発モードのフラッグシップスマートフォンでもありません。

モバイルはアニメーションに関して3つのことを変えます。このスキルのすべてはこれらに従います:

  1. ホバーは存在しない。 ウェブがホバーに置くすべてのアフォーダンスは、プレス、位置、または何もないところに存在しなければなりません。
  2. 2つのランタイムがある。 ワークレット(Reanimated 4)はこれを明示的にします:Reactがレンダリングしアプリロジックが実行されるReact Nativeランタイムと、ワークレットが毎フレーム実行されるUIランタイム(さらにバックグラウンドワーク用のオプションのワーカーランタイム)です。RNランタイムに触れるアニメーションは、アプリが他に何かをする瞬間にカクつきます。技術全体は、モーションをUIランタイムに維持することです。
  3. ユーザーの指が要素の上にある。 ジェスチャーが主要な入力であり、そのため割り込み可能性と速度のハンドオフは洗練ではなく、基本です。

運用姿勢

あなたは自身でアニメーションを構築するシニアモバイルエンジニアです。決定を下し、理由を一文で述べ、コードを書いてください。モーションの選択肢をメニューとして提示しないでください。

2つの障害モードがあり、最初のものがより悪いです:

  1. アニメーション化すべきでないものをアニメーション化する。 以下のゲートは、時にはゼロ行のコードを生成するために存在します。
  2. 正しいものを間違ったスレッドでアニメーション化する — フレームごとのsetState、PanResponder、アニメーション化されたheight。開発中のあなたのスマートフォンでは問題なく見えますが、3年前のAndroidでは20fpsに低下します。

ハードルール

  1. シーケンスを順番に実行する。 ステップ1と2がすべてをゲートします。
  2. Reanimated、コアのAnimatedではない。 コアのAnimatedはブリッジを越えずにジェスチャーで駆動できず、useNativeDriverはtransformとopacityしか受け付けません。ReanimatedのワークレットはUIスレッドで実行され、JSがビジーな間も実行を続けます。
  3. 近似値は使用しない。 カーブとスプリング設定は、以下のテーブルから取得します。
  4. モーション軽減はアニメーションと一緒に出荷する、後日対応としてではありません。
  5. フィーリングは、サポートする最も遅いデバイスでのリリースビルドで判断する。 それ以外は検証済みとはみなされません。

構築シーケンス

1. これはアニメーション化すべきか?

頻度決定
1日100回以上 — タブ切り替え、キーボード開閉、スクロール、設定のトグルアニメーションなし。 プラットフォームデフォルトまたはなし。ここで停止。
1日数十回 — プレスフィードバック、リストナビゲーション、行選択ほぼ知覚できないもののみ:150ms未満、またはなし
時々 — シート、モーダル、トースト、オンボーディングステップ標準アニメーション
稀 / 初回のみ — 成功状態、空状態のイラスト、祝福喜びの予算はここにあります

タブスイッチはスライドしない。 タブはピアであり、階層ではありません — スライドはそこにない深さを暗示し、ユーザーはセッション中にそれを何十回も支払います。 animation: 'none'。

リクエストがこのゲートを通過しない場合は、そう言ってコードを書かないでください。

2. 目的は何か?

続行する前に一文で名前を付けてください:フィードバック、空間的一貫性、状態表示、急激な変化の防止、説明、または喜び(稀な層のみ)。

名前を付けられない? 構築しないでください。

3. ツールを選択 — 動作する最も安価なもの

下に進んで、最初に適合するもので停止してください。

ニーズツール
ジェスチャーなしの状態駆動変化 — プレス、トグル、色、値の切り替えReanimated CSS transition(スタイル内のtransitionProperty)
ループ、複数ステージ、または状態変化なしでマウント時に再生Reanimated CSS animation(animationNameキーフレーム)
要素のマウント/アンマウント、またはリストの再フローLayout animations(entering / exiting / itemLayoutAnimation)
指が触れるもの、またはスクロールから派生するものuseSharedValue + Gesture + useAnimatedStyle
画面間Expo Routerのネイティブスタックオプション。 決して手動で実装しないでください
それ自体が画面であるボトムシートpresentation: 'formSheet' — それは本物のUISheetPresentationControllerであり、無料で正しいです
タブバーNativeTabs(expo-router/unstable-native-tabs から) — プラットフォームの実際のタブバー、その動作とトランジションを含む
コンテキストメニュー、長押しプレビューLink.Menu / Link.Preview(Expo Router、iOSのみ) — ネイティブメニューとピーク、JSで再構築しない
大きなタイトルに折りたたまれるヘッダーネイティブスタックのheaderLargeTitleEnabled(iOSのみ;headerLargeTitleは非推奨) — スクロールワークレットではない
プル・トゥ・リフレッシュRefreshControl — それが特徴的なインタラクションである場合のみ手動実装(しきい値レシピを参照)
キーボードを追跡するUIreact-native-keyboard-controller — キーボードの実際の位置、フレームごとに、UIスレッド上で
ベクターイラスト、祝福、空状態Lottie — イラストのみに、UI状態には決して使用しない
巨大なアニメーションシーン、自由形式描画@shopify/react-native-skia — キャンバス、ビュー階層自体がボトルネックとなる場合に使用

値が連続的または割り込み可能な場合にのみ、共有値を使用してください。プレススケールはCSSトランジションです。ドラッグは共有値です。2状態トグルにワークレットを使用することは、フェードのためにモーションライブラリをインストールするモバイル版です。

依存関係。 npx expo install <package> でインストールしてください — プロジェクトのSDKに一致するバージョンを解決します。これは通常のnpm installでは行われません:

ニーズパッケージ
アニメーションreact-native-reanimated + react-native-worklets
ジェスチャーreact-native-gesture-handler
ナビゲーション、シート、ネイティブタブ、メニューexpo-router
ハプティクスexpo-haptics
キーボード追従UIreact-native-keyboard-controller(ルートにKeyboardProviderが必要 — キーボードレシピを参照)
イラスト、祝福lottie-react-native
非常に大きなアニメーションシーン、カスタム描画@shopify/react-native-skia

4. プロパティを選択

  • transformとopacityは無料です。 それ以外はすべてレイアウトパスです。width、height、margin、padding、flex、top、left、gapは、そのノードとその兄弟のフレームごとにYogaを再実行します。
  • 唯一の例外:子のない絶対配置要素 — タブピル、プログレスバーの塗りつぶし。フローから外れているため、他のものは再レイアウトされず、widthのアニメーションはscaleXが伸ばすようなコーナー半径を維持します。
  • 決してscale(0)から始めないでください。 scale(0.9–0.97) + opacity: 0から始めてください。現実世界では何も無から現れません。
  • transformは配列であり、順序が重要です — [{ translateY }, { scale }]は移動後にスケールします。逆にすると、移動も拡大縮小されます。乗算が必要でなければ、translateを先にしてください。
  • Androidの影はelevationであり、elevationをアニメーション化するとフレームごとに影が再レンダリングされます。 代わりに、事前に影をつけたレイヤーのopacityをアニメーション化してください。
  • 決してBlurViewの強度をアニメーション化しないでください。 Androidではフレームごとにブラーを再レンダリングします。代わりに、静的なBlurViewのopacityをクロスフェードしてください。
  • パーセンテージはtranslateで機能し、要素自身のサイズに対して相対的です — translateY('100%')は、コンテンツに関係なくシートを自身の高さ分だけ移動します。

5. タイミングかスプリングか

指が関与した場合は、スプリングを使用してください。 スプリングは割り込みを通じて速度を伝達します。タイミングカーブは再起動します。それ以外はすべてタイミングを使用します。

Reanimatedのスプリングは、Appleの2つのデザイナーパラメータを直接受け取ります — mass/stiffness/dampingではなく、この形式を使用してください:

インタラクション設定
デフォルトの落ち着き、オーバーシュートなし{ duration: 400, dampingRatio: 1 }
ドラッグ後の再配置 / スナップバック{ duration: 400, dampingRatio: 0.8, velocity }
シート、ドロワー{ duration: 300, dampingRatio: 0.8, velocity }
ハードエッジを越えてはいけないovershootClamping: true を追加

ジェスチャーが勢いを持っていた場合のみバウンスさせる。 フェードインしたメニューのオーバーシュートは間違って感じられます。あなたが弾いたカードのオーバーシュートは正しく感じられます。

イージング、指がないものすべてに対して:

状況イージング
入場または退場ease-out
画面上での移動 / 変形ease-in-out
一定の動き(プログレス、マーキー)linear
デフォルトease-out

UIでは決してease-inを使用しないでください。 遅く始まり、ユーザーが見ている正確な瞬間を遅延させます。Reanimatedの組み込みはCSSのものと同じくらい弱いです — これらを使用してください:

import { Easing } from 'react-native-reanimated';

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // UI向けの強いイーズアウト
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // 画面上の動き
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // iOSシートカーブ

持続時間:

要素持続時間
プレスフィードバック100–150ms
トグル、チップ、小さな状態変化150–200ms
シート、モーダル、ドロワースプリング、~300ms知覚
画面遷移プラットフォームデフォルト — 上書きしないでください

モバイルUIアニメーションは、ウェブと同様に300ms未満に保ちます。プラットフォーム自身のトランジションはより長いですが(iOSプッシュは350ms)、ナビゲーションではプラットフォームに合わせ、それ以外ではそれを上回ります。

6. JSスレッドから遠ざける

これはモバイル固有の技術であり、ほとんどのReact Nativeモーションが死ぬ場所です。

  • ジェスチャーやスクロールハンドラから決してsetStateしないでください。 フレームごとに1回のReactレンダリングは、RNアプリにおけるカクつきの最大の原因です。共有値 → useAnimatedStyle、そしてReactはまったく再レンダリングしません。
  • onUpdateやスクロールハンドラ内でRNランタイムにスケジュールバックしないでください。 非推奨のrunOnJS(fn)(...args)に代わるReanimated 4のscheduleOnRN(fn, ...args)(react-native-workletsから)は、RNランタイム呼び出しをキューに入れます。onUpdate内では毎秒60~120回になります。これはonEndか、値がしきい値を超えたときに発火するuseAnimatedReactionに属します。
  • レンダリング中に共有値を読み取らないでください(JSX内のtranslateY.get())。それは決して更新されないスナップショットであり、静かに非同期になります。レンダリング中に書き込みもしないでください — 再調整の途中で発火し、あなたが引き起こさなかった再レンダリングが書き込みを再生します。ワークレット、ハンドラ、エフェクト内でのみ共有値に触れてください。
  • .valueではなく、.get() / .set()を使用してください。 同じAPIですが、直接の.valueアクセスは、Reactコンパイラが透過的に見ることができない形式です。Reanimatedのドキュメントでは、get/setをコンパイラセーフな方法と呼んでいます。setは関数型の更新も受け入れます:sv.set((v) => v + 1)。
  • ワークレットから呼び出される関数は、最初の行に'worklet'が必要です。 そうしないと、実行時にデバイス上でスローされます。デバッガーでは正常に動作しているにもかかわらずです。

7. プレス、ホバーではない

ウェブからのすべてのホバーアフォーダンスは、移植ではなく、再設計する必要があります。

  • プレスイン時にフィードバックを、プレスアウト時にコミットを。 タップが完了するまで何も表示しないのは死んでいるように感じられます — これはユーザーが実際に知覚するレイテンシです。
  • プレス可能なものに対して、scale: 0.97を100–150msで。 Pressable + CSSトランジション。scaleはラベルとアイコンも一緒に動かし、それが物理的に読み取られる理由です。
  • 44×44ptの最低タッチターゲット(Androidでは48dp)。ビジュアルが小さい場合は、hitSlopを追加してください。ビジュアルを大きくしないでください。
  • pressRetentionOffset により、指が数ピクセルずれても、ユーザーが意図したプレスがキャンセルされないようにします。
  • MaterialスタイルのアプリでのみAndroidリップルを使用する。 カスタムデザインのアプリでは、両方のプラットフォームで同じスケールを使用する方が、片方だけリップルを使用するよりも一貫性があります。

8. ハプティクス

モバイルにはウェブにはない感覚があります。控えめに使用すると、アプリが高級に感じられるものになります。どこでも使用すると、ユーザーはオフにします。

瞬間呼び出し
値がステップを刻む — ピッカー、スライダーデテント、セグメントコントロールHaptics.selectionAsync()
何かがホームにスナップする、シートデテントが引っかかる、ドラッグがコミットされるHaptics.impactAsync(ImpactFeedbackStyle.Light)
重いオブジェクトが着地する、破壊的アクションが発動するHaptics.impactAsync(ImpactFeedbackStyle.Medium)
操作が成功または失敗したHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

3つのルール、絶対です:

  • ビジュアルと同じフレームで。 アニメーションに遅れるハプティクスは、フィードバックではなくグリッチとして読み取られます。因果的な瞬間 — デテントが引っかかる瞬間 — に発火させてください。アニメーションが終了したときではありません。
  • ユーザーアクションごとに1回。 スクロール時には決して、フレームごとには決して、ユーザーが引き起こさなかったエントランスアニメーションでは決して使用しないでください。
  • 唯一のフィードバックにしないでください。 多くのユーザーはシステム全体でハプティクスをオフにしており、ほとんどのAndroidハードウェアでは無音です。ビジュアルは単独で機能する必要があります。

ワークレットからは、ハプティクスはRNランタイムにスケジュールバックする必要があります:scheduleOnRN(Haptics.selectionAsync)。

9. モーション軽減とアクセシビリティ

import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';

const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);

// または各アニメーションに決定させる
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

モーション軽減はより少なく、より穏やかにを意味し、ゼロではありません。状態変化を説明する不透明度や色の変化は保持し、移動、スケール、パララックス、オーバーシュートは削除します。画面遷移はanimation: 'fade'になります。

テキストスケール。 allowFontScalingはデフォルトでオンです。そのため、デフォルトのフォントサイズで測定した高さは、200%では間違っています。決してハードコードされた高さにアニメーション化しないでください — onLayoutで測定するか、代わりにtransformをアニメーション化してください。

静かにモーションを壊す設定

「アニメーションがただ実行されない」場合、まずこれらを確認してください:

  • Expoを通じてインストールし、バージョンがSDKと一致するようにする:npx expo install react-native-reanimated react-native-worklets。Expoプロジェクトでは、babel-preset-expoがワークレット用のBabelプラグインを自動的に設定します — 手動のbabel.config.js手順は不要です。そのプリセットがないベアRNプロジェクトのみが、手動でプラグインを追加します。

  • react-native-gesture-handlerが正しく設定されていることを確認する:ルートにGestureHandlerRootView。Expo Routerはデフォルトでこれを行いますが、ベアプロジェクトの場合は自分でラップする必要があります。

  • レイアウトアニメーションはExpo SDK 52以降の安定版に含まれています。<SkiaCanvas>内では、子に配置アニメーション (entering / exiting) を適用しないでください。代わりに手動で管理してください。

  • LottieはLottieViewをマウントするだけで自動的に再生されます。明示的にplay()を呼び出さないでください。

実機テストコマンド

npx expo run:ios --device     # iOS実機ビルド
npx expo run:android --device # Android実機ビルド

Individual skills in this repo

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

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

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

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.

関連スキル