Communitygithub.com

therts649-ai/Claude-Skills

Erstellen Sie native Animationen in React Native und Expo, indem Sie die richtigen Entscheidungen in der richtigen Reihenfolge treffen – ob animiert werden soll, auf welchem Thread, mit welchen Eigenschaften, mit Feder oder Timing, wie Gesten übergeben werden und wie die Animation degradiert. Nutzen Sie Implementierungen mit Reanimated, Gesture Handler, Expo Router und expo-haptics.

Was ist Claude-Skills?

Dieses Skill-Set ist ein umfassender Leitfaden für die Erstellung hochwertiger Animationen in React Native und Expo, der auf die besonderen Herausforderungen mobiler Plattformen eingeht. Es basiert auf der Animationsphilosophie von Emil Kowalski und betont, dass Animationen auf echten Geräten in Release-Builds getestet werden müssen, nicht im Simulator. Das Skill deckt eine vollständige Build-Sequenz ab, die mit der Entscheidung beginnt, ob eine Animation überhaupt notwendig ist, und sich dann Schritt für Schritt durch die Auswahl der richtigen Werkzeuge (wie CSS-Übergänge, Shared Values oder Lottie), der passenden Eigenschaften (z. B. Bevorzugung von `transform` und `opacity`) und der korrekten Thread-Verwaltung (Arbeiten mit der UI-Runtime über Reanimated 4 Worklets) arbeitet. Es enthält harte Regeln zur Vermeidung von JS-Thread-Belastung, zur Verwendung von Federn für gestenbasierte Interaktionen und zur Implementierung von Haptik und reduzierter Bewegung. Das Skill ist für Entwickler gedacht, die Animationen in Expo-Apps mit Bibliotheken wie `react-native-reanimated`, `react-native-gesture-handler`, `expo-router` und `expo-haptics` erstellen, und es bietet detaillierte Referenzen für Timing-Kurven, Dauer, Haptik-Auslöser und Einrichtungshinweise, um häufige Fehler (wie die Verwendung von `runOnJS` in `onUpdate`) zu vermeiden.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/therts649-ai/Claude-Skills/tree/HEAD/plugins/emil-design/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 dieses Skill zum ersten Mal ohne 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.

Ein Konstruktions-Skill für React Native. Es wandelt eine Anfrage nach Bewegung in eine Implementierung um, die einer strengen Überprüfung auf einem echten Gerät standhält – nicht im Simulator, nicht auf einem High-End-Telefon im Dev-Modus.

Mobile Geräte verändern drei Dinge an Animationen, und alles in diesem Skill folgt daraus:

  1. Es gibt kein Hover. Jedes Hilfsmittel, das das Web in Hover bereitstellt, 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 in dem Moment, in dem die App etwas anderes tut. Die ganze Kunst besteht darin, 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 Optionen – sie sind die Grundlage.

Arbeitshaltung

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

Zwei Fehlermodi, wobei der erste schlimmer ist:

  1. Etwas animieren, das nicht animiert werden sollte. Die unten stehende Hürde dient dazu, manchmal null Zeilen Code zu produzieren.
  2. Das Richtige auf dem falschen Thread animieren – ein setState pro Frame, ein PanResponder, eine animierte height. Im Dev-Modus auf deinem Telefon sieht es gut aus und fällt auf einem drei Jahre alten Android auf 20 fps.

Strenge Regeln

  1. Führe die Sequenz in der Reihenfolge aus. Schritt 1 und 2 kontrollieren 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 weigert sich, etwas anderes als transform und opacity zu akzeptieren. Reanimated-Worklets laufen auf dem UI-Thread und laufen weiter, während JS beschäftigt ist.
  3. Keine angenäherten Werte. Kurven und Federkonfigurationen stammen aus den Tabellen unten.
  4. Reduzierte Bewegung wird mit der Animation ausgeliefert, nicht als nachträgliche Ergänzung.
  5. Das Gefühl wird auf einem Release-Build auf dem langsamsten unterstützten Gerät beurteilt. Nichts anderes zählt als verifiziert.

Die Build-Sequenz

1. Sollte dies überhaupt animieren?

HäufigkeitEntscheidung
100+ Mal/Tag – Tab-Wechsel, Tastatur öffnen/schließen, Scrollen, Umschalten in EinstellungenKeine Animation. Plattformstandard oder nichts. Hier aufhören.
Dutzende Male/Tag – Druck-Feedback, Listennavigation, ZeilenauswahlNur kaum wahrnehmbar: unter 150ms, oder nichts
Gelegentlich – Sheets, Modale, Toasts, Onboarding-SchritteStandardanimation
Selten / erstmalig – Erfolgszustände, Illustrationen für leere Zustände, FeierlichkeitenDas Ausgabenbudget liegt hier

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

Wenn die Anfrage diese Hürde nicht besteht, sag es und schreibe sie nicht.

2. Was ist der Zweck?

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

Kannst du ihn nicht benennen? Baue es nicht.

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

Gehe die Liste durch; halte beim ersten passenden an.

BedarfWerkzeug
Ein zustandsgesteuerter Wechsel ohne Geste – Drücken, Umschalten, Farbe, ein Wert, der umkipptReanimated CSS-Übergang (transitionProperty im Style)
Schleife, mehrstufig oder wird beim Einhängen ohne Zustandsänderung abgespieltReanimated CSS-Animation (animationName-Keyframes)
Ein Element, das ein- oder ausgehängt wird, oder ein Listen-ReflowLayout-Animationen (entering / exiting / itemLayoutAnimation)
Alles, was ein Finger berührt, oder alles, was vom Scrollen abgeleitet wirduseSharedValue + Gesture + useAnimatedStyle
Bildschirm zu BildschirmNative Stack-Optionen im Expo Router. Dies niemals selbst erstellen
Ein Bottom Sheet, das ein eigener Bildschirm istpresentation: 'formSheet' – es ist ein echter UISheetPresentationController, kostenlos und korrekt
Tab-LeisteNativeTabs (aus expo-router/unstable-native-tabs) – die echte Tab-Leiste der Plattform, einschließlich ihrer Verhaltensweisen und Übergänge
Kontextmenü, Vorschau durch Drücken und HaltenLink.Menu / Link.Preview (Expo Router, nur iOS) – native Menüs und Peek, niemals in JS neu erstellt
Kopfzeile, die in einen großen Titel einklapptheaderLargeTitleEnabled auf dem native Stack (nur iOS; headerLargeTitle ist veraltet) – kein Scroll-Worklet
Ziehen zum AktualisierenRefreshControl – nur selbst erstellen, wenn es sich um eine signifikante Interaktion handelt (siehe das Schwellenwert-Rezept)
UI, die der Tastatur folgtreact-native-keyboard-controller – die reale Position der Tastatur, Frame für Frame, auf dem UI-Thread
Vektorillustration, Feier, leerer ZustandLottie – nur für Illustrationen, niemals für den UI-Zustand
Eine riesige animierte Szene, Freihandzeichnen@shopify/react-native-skia – ein Canvas, für wenn die Ansichtshierarchie selbst der Engpass ist

Greife nur zu einem Shared Value, wenn der Wert kontinuierlich oder unterbrechbar ist. Ein Druck-Maßstab ist ein CSS-Übergang; ein Ziehen ist ein Shared Value. Ein Worklet für einen Zwei-Zustands-Umschalter zu verwenden, 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, Sheets, native Tabs, Menüsexpo-router
Haptikexpo-haptics
Tastaturverfolgende UIreact-native-keyboard-controller (benötigt KeyboardProvider an der Wurzel – siehe Tastatur-Rezept)
Illustration, Feierlottie-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 bei jedem Frame für diesen Knoten und seine Geschwister erneut aus.
  • Die eine Ausnahme: ein absolut positioniertes Element ohne Kinder – eine Tab-Pille, ein Fortschrittsbalken-Füllstand. Es ist aus dem Fluss heraus, daher wird nichts anderes neu angeordnet, und die Animation von width behält die Eckenrundung, die scaleX verschmieren würde.
  • Niemals scale(0). Beginne mit 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. Halte translate zuerst, es sei denn, du möchtest die Multiplikation.
  • Android-Schatten sind elevation, und die Animation von elevation rendert den Schatten jeden Frame neu. Animiere stattdessen die Deckkraft einer vorschattierten Ebene.
  • Animiere niemals die Intensität von BlurView. Auf Android rendert es die Unschärfe bei jedem Frame neu. Verwende stattdessen einen Überblendung der Deckkraft eines statischen BlurView.
  • Prozentsätze funktionieren bei translate und sind relativ zur eigenen Größe des Elements – translateY('100%') bewegt ein Sheet um seine eigene Höhe, unabhängig vom Inhalt.

5. Timing oder Feder

Wenn ein Finger beteiligt war, verwende eine Feder. Federn transportieren Geschwindigkeit durch eine Unterbrechung; Timing-Kurven starten neu. Alles andere verwendet Timing.

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

InteraktionKonfiguration
Standard-Setzen, kein Überschwingen{ duration: 400, dampingRatio: 1 }
Neupositionierung / Zurückschnellen nach einem Ziehen{ duration: 400, dampingRatio: 0.8, velocity }
Sheet, Schublade{ duration: 300, dampingRatio: 0.8, velocity }
Darf eine harte Kante nicht überschreitenfüge overshootClamping: true hinzu

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

Easing, für alles ohne Finger darauf:

SituationEasing
Betreten oder Verlassenease-out
Bewegen / Verwandeln auf dem Bildschirmease-in-out
Konstante Bewegung (Fortschritt, Laufschrift)linear
Standardease-out

Niemals ease-in bei der UI. Es startet langsam und verzögert den genauen Moment, den der Benutzer beobachtet. Reanimateds eingebaute 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-Sheet-Kurve

Dauer:

ElementDauer
Druck-Feedback100–150ms
Umschalter, Chip, kleine Zustandsänderung150–200ms
Sheet, Modal, SchubladeFeder, ~300ms wahrgenommen
Bildschirmübergangder Plattformstandard – überschreibe ihn nicht

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

6. Halte es vom JS-Thread fern

Dies ist die mobile Spezialdisziplin und hier stirbt die meiste Bewegung in React Native.

  • Niemals setState von einem Gesten- oder Scroll-Handler. Ein React-Render pro Frame ist die häufigste Ursache für Ruckeln in RN-Apps. Shared Value → useAnimatedStyle, und React rendert überhaupt nicht neu.
  • Niemals innerhalb von onUpdate oder einem Scroll-Handler zurück in die RN-Laufzeit planen. scheduleOnRN(fn, ...args) aus 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× pro Sekunde. Es gehört in onEnd oder in eine useAnimatedReaction, die ausgelöst wird, wenn ein Wert eine Schwelle überschreitet.
  • Niemals einen Shared Value während des Renders lesen (translateY.get() in JSX). Es ist ein Schnappschuss, der niemals aktualisiert wird und leise desynchronisiert. Niemals während des Renders einen schreiben – es feuert mitten in der Wiederherstellung, und ein 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 Zugriff auf .value ist die Form, die der React Compiler nicht durchschauen kann – die Reanimated-Dokumentation bezeichnet get/set als die compiler-sichere Methode. 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, während sie im Debugger einwandfrei funktionieren.

7. Drücken, nicht Hover

Jede Hover-Hilfsfunktion aus dem Web muss neu gestaltet, nicht portiert werden.

  • Feedback beim Herunterdrücken, Commit beim Loslassen. Zu warten, bis der Tipp abgeschlossen ist, bevor etwas angezeigt wird, fühlt sich tot an – dies ist die Latenz, die der Benutzer tatsächlich wahrnimmt.
  • scale: 0.97 in 100–150ms bei jedem drückbaren Element, Pressable + ein CSS-Übergang. scale nimmt das Label und die Symbole mit, was es physisch erscheinen lässt.
  • 44×44pt minimale Berührungszielgröße (48dp Android). Wenn das Visuelle kleiner ist, füge hitSlop hinzu – vergrößere das Visuelle nicht.
  • pressRetentionOffset damit ein Finger, der ein paar Pixel abdriftet, einen beabsichtigten Druck nicht abbricht.
  • Android-Welle nur in einer Material-styling-App. In einer benutzerdefinierten App ist derselbe Maßstab auf beiden Plattformen kohärenter als eine Welle auf einer.

8. Haptik

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

MomentAufruf
Ein Wert tickt über einen Schritt – Picker, Slider-Raster, Segmentierte SteuerungHaptics.selectionAsync()
Etwas rastet ein, ein Sheet-Raster fängt, ein Ziehen wird bestätigtHaptics.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 die Visualisierung. Eine Haptik, die ihrer Animation hinterherhinkt, liest sich als Störung, nicht als Feedback. Löse sie im ursächlichen Moment aus – dem Einrasten des Rasters – 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 stumm. Das Visuelle muss allein funktionieren.

Von einem Worklet aus muss Haptik zurück in die 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'.

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

Einrichtung, die Bewegung stillschweigend unterbricht

Ü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, und das …

[Fortsetzung folgt…]

Individual skills in this repo

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

Verwandte Skills