Communitygithub.com

CharbelElBateh/personal-website

Erstellt Animationen in React Native und Expo und trifft Entscheidungen in der Reihenfolge, die bestimmt, ob sie sich richtig anfühlen – ob es animieren soll, auf welchem Thread es läuft, welche Eigenschaften, Spring oder Timing, wie die Geste übergeben wird, wie es degradiert. Implementiert mit Reanimated, Gesture Handler, Expo Router und expo-haptics. Verwenden beim Animieren von etwas in einer Expo-App, Hinzufügen von Gesten, Blättern, Bildschirmübergängen, Druck-Feedback oder Haptik oder Beheben von Rucklern auf dem Gerät. Für Web-Animationen `animate` verwenden.

Was ist personal-website?

Diese Skill konzentriert sich auf die Erstellung von hochwertigen, geräteoptimierten Animationen in React Native und Expo, basierend auf der Animationsphilosophie von Emil Kowalski. Sie priorisiert das Gefühl auf echten Geräten gegenüber Simulatoren und behandelt mobile Besonderheiten wie fehlende Hover-Zustände, zwei Laufzeiten (React Native und UI-Thread) und Gesten als primäre Eingabe. Die Skill bietet eine schrittweise Anleitung, um zu entscheiden, ob eine Animation überhaupt nötig ist, das richtige Werkzeug (z. B. Reanimated CSS, Shared Values, Lottie) zu wählen, Eigenschaften wie transform oder opacity zu priorisieren, das richtige Timing oder Spring-Verhalten zu wählen und Animationen vom JS-Thread fernzuhalten, um Ruckler zu vermeiden. Sie behandelt auch Haptik, Presseffekte und Reduzierte-Bewegung-Barrierefreiheit. Unterstützte Plattformen sind Expo und React Native mit Paketen wie `react-native-reanimated`, `react-native-gesture-handler`, `expo-router`, `expo-haptics` und `lottie-react-native`.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Animationen in Expo erstellen

Erstantwort

Wenn diese Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, Animationen in Expo und React Native zu erstellen, die sich auf einem echten Gerät richtig anfühlen. Mein Wissen stammt aus Emil Kowalskis Animationsphilosophie.

Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.

Eine Baufähigkeit für React Native. Sie verwandelt eine Anfrage nach Bewegung in eine Implementierung, die einer strengen Überprüfung auf einem echten Gerät standhält – nicht im Simulator, nicht auf einem Flaggschiff-Telefon im Entwicklermodus.

Mobile Geräte ändern drei Dinge an Animationen, und alles in dieser Fähigkeit folgt daraus:

  1. Es gibt keinen Hover-Zustand. Jeder Hinweis, den das Web in Hover legt, muss in Druck, Position oder nichts leben.
  2. Es gibt zwei Laufzeiten. Worklets (Reanimated 4) machen dies explizit: die React Native-Laufzeit, in der React rendert und deine App-Logik läuft, und die UI-Laufzeit, in der Worklets jeden Frame ausführen (plus optionale Worker-Laufzeiten für Hintergrundarbeit). Eine Animation, die die RN-Laufzeit berührt, ruckelt, sobald die App etwas anderes tut. Die ganze Kunst besteht darin, die Bewegung auf der UI-Laufzeit zu halten.
  3. Der Finger des Benutzers liegt auf dem Element. Gesten sind die primäre Eingabe, daher sind Unterbrechbarkeit und Geschwindigkeitsübergabe keine Verfeinerung – sie sind die Grundlage.

Betriebshaltung

Du bist ein leitender Mobile-Engineer, der die Animation selbst erstellt. Triff die Entscheidung, nenne die Begründung in einem Satz, schreibe den Code. Präsentiere Bewegungsoptionen niemals als Menü.

Zwei Fehlermodi, und der erste ist schlimmer:

  1. Etwas zu animieren, das nicht animiert werden sollte. Die untenstehende Prüfung existiert, um manchmal null Codezeilen zu produzieren.
  2. Das Richtige auf dem falschen Thread zu animieren – ein setState pro Frame, ein PanResponder, eine animierte height. Es sieht im Entwicklungsmodus auf deinem Telefon gut aus und fällt auf einem drei Jahre alten Android auf 20 fps.

Harte Regeln

  1. Führe die Schritte in der Reihenfolge aus. Schritte 1 und 2 sind die Tore für alles.
  2. Reanimated, nicht das Kern-Animated. Das Kern-Animated kann nicht von einer Geste gesteuert werden, ohne die Brücke zu überqueren, und useNativeDriver lehnt sowieso alles außer transform und opacity ab. Reanimated-Worklets laufen auf dem UI-Thread und laufen weiter, während JavaScript beschäftigt ist.
  3. Keine approximierten Werte. Kurven und Spring-Konfigurationen stammen aus den folgenden Tabellen.
  4. Reduzierte Bewegung wird mit der Animation ausgeliefert, nicht als Nachbesserung.
  5. Das Gefühl wird anhand eines Release-Builds auf dem langsamsten unterstützten Gerät beurteilt. Nichts anderes zählt als verifiziert.

Die Ablauf-Folge

1. Sollte dies überhaupt animieren?

HäufigkeitEntscheidung
100+ Mal/Tag – Tab-Wechsel, Tastatur öffnen/schließen, Scrollen, Umschalter in EinstellungenKeine Animation. Plattformstandard oder nichts. Hier aufhören.
Dutzende Male/Tag – Druck-Feedback, Listennavigation, ZeilenauswahlNur kaum wahrnehmbar: unter 150ms, oder nichts
Gelegentlich – Blätter, Modale, Toasts, Onboarding-SchritteStandard-Animation
Selten / Erstmalig – Erfolgszustände, Illustrationen im Leeren, FeierlichkeitenDas Freudenbudget lebt hier

Tab-Wechsel gleiten nie. Tabs sind gleichrangig, keine Hierarchie – Gleiten impliziert Tiefe, die nicht vorhanden ist, und der Benutzer bezahlt dafür dutzende Male pro Sitzung. animation: 'none'.

Wenn die Anfrage dieses Tor nicht passiert, sag es und schreibe es nicht.

2. Was ist der Zweck?

Benenne ihn in einem Wort, bevor du fortfährst: feedback, räumliche Konsistenz, Zustandsanzeige, Verhindern einer ruckartigen Änderung, Erklärung oder Freude (nur seltene Stufe).

Kannst du es nicht benennen? Bau es nicht.

3. Wähle das Werkzeug – das günstigste, das funktioniert

Gehe hinunter; bleibe beim ersten, das passt.

BedarfWerkzeug
Eine zustandsgesteuerte Änderung ohne Geste – Drücken, Umschalten, Farbe, ein Wert, der umschaltetReanimated CSS transition (transitionProperty im Style)
Schleife, mehrstufig oder spielt beim Einblenden ohne ZustandsänderungReanimated CSS animation (animationName Keyframes)
Ein Element, das ein- oder ausgeblendet wird, oder eine Liste, die umfließtLayout-Animationen (entering / exiting / itemLayoutAnimation)
Alles, was ein Finger berührt, oder alles, was vom Scrollen abgeleitet wirduseSharedValue + Gesture + useAnimatedStyle
Bildschirm zu BildschirmNative Stack-Optionen in Expo Router. Niemals selbst machen.
Ein unteres Blatt, das ein eigener Bildschirm istpresentation: 'formSheet' – es ist ein echter UISheetPresentationController, kostenlos und korrekt
Tab-LeisteNativeTabs (von expo-router/unstable-native-tabs) – die echte Tab-Leiste der Plattform, inklusive ihrer Verhaltensweisen und Übergänge
Kontextmenü, Vorschau per langem DruckLink.Menu / Link.Preview (Expo Router, nur iOS) – native Menüs und Peek, nie in JS nachgebaut
Kopfzeile, die in einen großen Titel einklapptheaderLargeTitleEnabled auf dem nativen Stack (nur iOS; headerLargeTitle ist veraltet) – kein Scroll-Worklet
Pull to RefreshRefreshControl – nur selbst machen, wenn es sich um eine signifikante Interaktion handelt (siehe das Schwellen-Rezept)
UI, die der Tastatur folgtreact-native-keyboard-controller – die tatsächliche Position der Tastatur, Frame für Frame, auf dem UI-Thread
Vektorillustration, Feierlichkeit, leerer ZustandLottie – nur für Illustrationen, niemals für UI-Zustände
Eine riesige animierte Szene, Freihandzeichnung@shopify/react-native-skia – eine Leinwand, wenn die View-Hierarchie selbst der Flaschenhals ist

Greife nur zu einem Shared Value, wenn der Wert kontinuierlich oder unterbrechbar ist. Eine Druckskalierung ist ein CSS-Übergang; ein Drag ist ein Shared Value. Die Verwendung eines Worklets für einen Zwei-Zustands-Umschalter ist das mobile Äquivalent zur Installation einer Bewegungsbibliothek für ein Einblenden.

Abhängigkeiten. Installiere mit npx expo install <package> – es löst die Version auf, die zum SDK des Projekts passt, was einfaches npm install nicht tut:

BedarfPaket
Animationreact-native-reanimated + react-native-worklets
Gestenreact-native-gesture-handler
Navigation, Blätter, native Tabs, Menüsexpo-router
Haptikexpo-haptics
Tastatur-folgende UIreact-native-keyboard-controller (benötigt KeyboardProvider an der Wurzel – siehe das Tastatur-Rezept)
Illustration, Feierlichkeitlottie-react-native
Sehr große animierte Szenen, benutzerdefiniertes Zeichnen@shopify/react-native-skia

4. Wähle die Eigenschaften

  • transform und opacity sind kostenlos. Alles andere ist ein Layout-Durchlauf. width, height, margin, padding, flex, top, left, gap führen Yoga auf diesem Knoten und seinen Geschwistern jeden Frame neu aus.
  • Die eine Ausnahme: ein absolut positioniertes Element ohne Kinder – ein Tab-Pill, ein Fortschrittsbalken. Es ist aus dem Fluss genommen, daher wird nichts anderes neu angeordnet, und das Animieren von width behält den Eckradius, den scaleX verschmieren würde.
  • Niemals scale(0). Starte von scale(0.9–0.97) + opacity: 0. Nichts in der realen Welt erscheint aus dem Nichts.
  • transform ist ein Array und die Reihenfolge ist wichtig – [{ translateY }, { scale }] skaliert nach dem Verschieben; umgekehrt wird auch die Verschiebung skaliert. Behalte translate zuerst, es sei denn, du willst die Multiplikation.
  • Android-Schatten sind elevation, und das Animieren von elevation rendert den Schatten jeden Frame neu. Animiere stattdessen die Deckkraft einer vorschattierten Ebene.
  • Niemals die Intensität von BlurView animieren. Unter Android rendert es die Unschärfe jeden Frame neu. Verwende stattdessen einen Überblendung der Deckkraft eines statischen BlurView.
  • Prozentangaben funktionieren in translate und sind relativ zur eigenen Größe des Elements – translateY('100%') bewegt ein Blatt um seine eigene Höhe, unabhängig vom Inhalt.

5. Timing oder Spring

Wenn ein Finger beteiligt war, verwende einen Spring. Springs übertragen die Geschwindigkeit durch eine Unterbrechung; Timing-Kurven starten neu. Alles andere verwendet Timing.

Reanimateds Spring akzeptiert Apples zwei Designer-Parameter direkt – verwende diese Form, nicht Masse/Steifigkeit/Dämpfung:

InteraktionKonfiguration
Standardbereich, kein Überschwingen{ duration: 400, dampingRatio: 1 }
Neupositionierung / Zurückschnappen nach einem Drag{ duration: 400, dampingRatio: 0.8, velocity }
Blatt, Drawer{ duration: 300, dampingRatio: 0.8, velocity }
Darf eine harte Kante nicht überschreitenovershootClamping: true hinzufügen

Bounce nur, wenn die Geste Impuls trug. Überschwingen bei einem Menü, das eingeblendet wurde, fühlt sich falsch an; Überschwingen bei einer Karte, die du geworfen hast, fühlt sich richtig an.

Easing, für alles ohne Fingerkontakt:

SituationEasing
Ein- oder ausgehendease-out
Bewegen / Umformen auf dem Bildschirmease-in-out
Ständige Bewegung (Fortschritt, Lauftext)linear
Standardease-out

Niemals ease-in auf der UI. Es beginnt langsam und verzögert den genauen Moment, den der Benutzer beobachtet. Die eingebauten von Reanimated sind so schwach wie die von CSS – verwende diese:

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

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // starkes ease-out für UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // Bewegung auf dem Bildschirm
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // iOS Blatt-Kurve

Dauer:

ElementDauer
Druck-Feedback100–150ms
Umschalter, Chip, kleine Zustandsänderung150–200ms
Blatt, Modal, Drawerspring, ~300ms wahrgenommen
Bildschirmübergangder Plattformstandard – nicht überschreiben

Mobile UI-Animationen bleiben unter 300ms, genauso wie im Web. Die eigenen Übergänge der Plattform sind länger (iOS Push ist 350ms); passe dich für die Navigation der Plattform an, übertreffe sie überall sonst.

6. Halte es vom JS-Thread fern

Dies ist das mobilspezifische Handwerk, und hier stirbt die meiste React Native-Bewegung.

  • Niemals setState von einem Gesten- oder Scroll-Handler. Ein React-Render pro Frame ist die häufigste Ursache für Ruckler in RN-Apps. Shared Value → useAnimatedStyle, und React rendert überhaupt nicht neu.
  • Niemals einen Rückruf zur RN-Laufzeit innerhalb von onUpdate oder einem Scroll-Handler planen. scheduleOnRN(fn, ...args) von react-native-worklets – der Reanimated 4-Ersatz für das veraltete runOnJS(fn)(...args) – stellt einen RN-Laufzeit-Aufruf in die Warteschlange, und in onUpdate sind das 60–120 Mal pro Sekunde. Es gehört in onEnd oder in eine useAnimatedReaction, die ausgelöst wird, wenn ein Wert einen Schwellenwert überschreitet.
  • Niemals einen Shared Value während des Renderings lesen (translateY.get() in JSX). Es ist ein Schnappschuss, der nie aktualisiert wird und lautlos desynchronisiert. Niemals einen während des Renderings schreiben – es wird mitten in der Neuabstimmung ausgelöst, und ein von dir nicht verursachtes Neu-Rendering wiederholt das Schreiben. Berühre Shared Values nur in Worklets, Handlern und Effekten.
  • Verwende .get() / .set(), nicht .value. Gleiche API, aber der direkte .value-Zugriff ist die Form, die der React Compiler nicht durchschauen kann – die Reanimated-Dokumentation nennt get/set den compiler-sicheren Weg. set akzeptiert auch ein funktionales Update: sv.set((v) => v + 1).
  • Funktionen, die von einem Worklet aufgerufen werden, benötigen 'worklet' als erste Zeile, sonst werfen sie zur Laufzeit auf dem Gerät einen Fehler, obwohl sie im Debugger einwandfrei funktionieren.

7. Drücken, nicht Hover

Jeder Hover-Hinweis aus dem Web muss neu gestaltet, nicht portiert werden.

  • Feedback beim Drücken, Ausführen beim Loslassen. Warten, bis der Tippvorgang abgeschlossen ist, bevor irgendetwas angezeigt wird, fühlt sich tot an – das ist die Latenz, die der Benutzer tatsächlich wahrnimmt.
  • scale: 0.97 in 100–150ms auf jedem drückbaren Element, Pressable + ein CSS-Übergang. scale nimmt das Label und die Icons mit, was es als physisch lesbar macht.
  • 44×44pt minimale Berührungsfläche (48dp Android). Wenn das Visuelle kleiner ist, füge hitSlop hinzu – vergrößere nicht das Visuelle.
  • pressRetentionOffset, damit ein Finger, der ein paar Pixel abdriftet, einen Druck nicht abbricht, den der Benutzer beabsichtigt hat.
  • Android-Welle nur in einer Material-stylisierten App. In einer benutzerdefinierten App ist dieselbe Skalierung auf beiden Plattformen kohärenter als eine Welle auf einer.

8. Haptik

Mobile hat einen Sinn, den das Web nicht hat. Verwende ihn sparsam, und er wird das Ding, das die App teuer wirken lässt; verwende ihn überall, und die Benutzer schalten ihn aus.

MomentAufruf
Ein Wert tickt über einen Schritt – Picker, Slider-Rastung, Segmentierte SteuerungHaptics.selectionAsync()
Etwas rastet ein, ein Blatt rastet ein, ein Drag wird abgeschlossenHaptics.impactAsync(ImpactFeedbackStyle.Light)
Ein schweres Objekt landet, eine destruktive Aktion wird ausgelöstHaptics.impactAsync(ImpactFeedbackStyle.Medium)
Vorgang erfolgreich oder fehlgeschlagenHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

Drei Regeln, und sie sind absolut:

  • Gleicher Frame wie das Visuelle. Eine Haptik, die ihrer Animation hinterherhinkt, wirkt wie ein Fehler, nicht wie Feedback. Löse sie im ursächlichen Moment aus – dem Einrasten –, nicht wenn die Animation endet.
  • Eine pro Benutzeraktion. Niemals beim Scrollen, niemals pro Frame, niemals bei einer Eingangsanimation, die der Benutzer nicht verursacht hat.
  • Niemals das einzige Feedback. Haptik ist bei vielen Benutzern systemweit ausgeschaltet und auf den meisten Android-Geräten still. Das Visuelle muss allein funktionieren.

Von einem Worklet aus muss die Haptik zurück zur RN-Laufzeit geplant werden: scheduleOnRN(Haptics.selectionAsync).

9. Reduzierte Bewegung und Barrierefreiheit

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

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

// oder jede Animation entscheiden lassen
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

Reduzierte Bewegung bedeutet weniger und sanfter, nicht null: behalte Deckkraft- und Farbänderungen bei, die eine Zustandsänderung erklären, entferne Translation, Skalierung, Parallaxe und Überschwingen. Bildschirmübergänge werden zu animation: 'fade'.

Textskalierungen. allowFontScaling ist standardmäßig aktiviert, daher ist jede Höhe, die du bei Standardschriftgröße gemessen hast, bei 200% falsch. Animiere niemals auf eine fest codierte Höhe – messe mit onLayout oder animiere stattdessen eine Transformation.

Setup, das stillschweigend Bewegungen zerstört

Überprüfe diese zuerst, wenn "die Animation einfach nicht läuft":

  • Installiere über Expo, damit die Versionen zum SDK passen: npx expo install react-native-reanimated react-native-worklets. In einem Expo-Projekt konfiguriert babel-preset-expo das Worklets-Babel-Plugin automatisch – kein babel.config.js-Schritt. Nur ein reines RN-Projekt ohne dieses Preset fügt das Plugin manuell hinzu, ein...

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.

Verwandte Skills