Communitygithub.com

Asymmetric-al/core

Erstellen Sie Animationen für Expo und React Native mit Reanimated, Gesture Handler, Expo Router und expo-haptics. Nur verwenden, wenn die Zielplattform eine Expo- oder React Native-App ist. Nicht für Core Next.js Web-Animationen nutzen; dafür `animate` verwenden. Wird nur bei explizitem Aufruf ausgeführt.

Was ist core?

Diese Fähigkeit ist ein spezialisiertes Werkzeug zum Erstellen von Animationen und Gesten in React Native- und Expo-Apps. Sie stellt sicher, dass Bewegungen auf dem natives UI-Thread ausgeführt werden (über Reanimated Worklets), um Ruckeln zu vermeiden. Die Fähigkeit folgt einem strengen Entscheidungsprozess: Zuerst wird geprüft, ob überhaupt eine Animation nötig ist (häufige Aktionen wie Tab-Wechsel erhalten keine Animation). Dann wird der Zweck der Animation definiert (z. B. Feedback oder räumliche Konsistenz) und das günstigste Werkzeug ausgewählt – von CSS-Übergängen bis zu geteilten Werten und Gesten. Wichtige Faustregeln: Keine Hover-Zustände (da es auf Mobilgeräten keinen Cursor gibt), keine `setState`-Aufrufe in Gesten-Handlern, keine Animation von Layout-Eigenschaften wie `width` oder `height`, da diese einen teuren Layout-Durchlauf auslösen. Stattdessen werden `transform` und `opacity` bevorzugt, die GPU-beschleunigt sind. Die Fähigkeit unterstützt nur Expo/React Native und wird nicht für Web-Apps von Core geladen. Sie wird von Senior-Ingenieuren verwendet, die Animationen selbst umsetzen – nicht als Berater, die Optionen vorschlagen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate-expo

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animationen in Expo bauen

Dieses Repository (Asymmetric-al/core)

Diese Fähigkeit ist ausschließlich für React Native / Expo Motion gedacht. Core Next.js-Apps sollten stattdessen animate, emil-design-engineering und anim verwenden. Stimmen Sie dieses Overlay nach Upstream-Aktualisierungen ab, bevor Sie bun run skills:sync ausführen.

Auslöser

  • Explizite Expo- oder React Native-Animationen, Gesten, Sheets oder Haptik.
  • Nicht laden für Core Web-Apps (apps/admin, apps/donor, apps/missionary) oder geteilte packages/ui Web-Motion.

Arbeitsablauf

  1. Bestätigen Sie, dass die Anfrage nativ/Expo ist, bevor Sie Reanimated-Rezepte anwenden.
  2. Hören Sie bei Core Next.js-Oberflächen auf und laden Sie animate plus anim.

Checkliste

  • Die Zielplattform ist Expo/React Native, nicht Cores App Router-Apps.
  • Web-Motion folgt weiterhin Core-Tokens und Base UI.

Eine Konstruktionsfä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 Plattformen ändern drei Dinge an Animationen, und alles in dieser Fähigkeit folgt daraus:

  1. Es gibt keinen Hover. Jede Interaktionsmöglichkeit, die das Web in Hover legt, muss in Druck, Position oder nichts existieren.
  2. Es gibt zwei Laufzeiten. Worklets (Reanimated 4) machen dies explizit: die React Native-Laufzeit, in der React rendert und Ihre 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 Basis.

Arbeitsweise

Sie sind ein leitender Mobile-Ingenieur, der die Animation selbst baut. Treffen Sie die Entscheidung, geben Sie die Begründung in einem Satz an, schreiben Sie den Code. Präsentieren Sie niemals Bewegungsoptionen als Menü.

Zwei Fehlermodi, und der erste ist schlimmer:

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

Harte Regeln

  1. Führen Sie die Sequenz in der Reihenfolge aus. Die Schritte 1 und 2 sind das Tor zu allem.
  2. Reanimated, nicht das Kern-Animated. Kern-Animated kann nicht von einer Geste gesteuert werden, ohne die Brücke zu überqueren, und useNativeDriver weigert sich ohnehin alles außer Transform und Opacity. 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 folgenden Tabellen.
  4. Reduzierte Bewegung wird mit der Animation ausgeliefert, nicht als nachträgliche Änderung.
  5. Das Gefühl wird auf einem Release-Build auf dem langsamsten unterstützten Gerät bewertet. Nichts anderes zählt als verifiziert.

Die Bau-Sequenz

1. Sollte dies überhaupt animieren?

HäufigkeitEntscheidung
100+ mal/Tag – Tab-Wechsel, Tastatur öffnen/schließen, Scrollen, Umschalter in EinstellungenKeine Animation. Plattform-Standard oder nichts. Hier anhalten.
Dutzende mal/Tag – Druck-Feedback, Listennavigation, ZeilenauswahlNur kaum wahrnehmbar: unter 150ms, oder nichts
Gelegentlich – Sheets, Modals, Toasts, Onboarding-SchritteStandard-Animation
Selten / zum ersten Mal – Erfolgszustände, Leerzustands-Illustrationen, FeierlichkeitenDas Freudenbudget lebt hier

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

Wenn die Anfrage diese Hürde nicht besteht, sagen Sie das und schreiben Sie nichts.

2. Was ist der Zweck?

Benennen Sie es in einem Wort, bevor Sie fortfahren: Feedback, räumliche Konsistenz, Zustandsanzeige, Verhindern einer ruckartigen Änderung, Erklärung oder Freude (nur seltene Kategorie).

Können Sie es nicht benennen? Bauen Sie es nicht.

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

Gehen Sie die Liste durch; halten Sie beim ersten an, das passt.

BedarfWerkzeug
Eine zustandsgesteuerte Änderung ohne Geste – Druck, Umschalter, Farbe, ein Wert, der umkipptReanimated CSS-Übergang (transitionProperty im Style)
Schleife, mehrstufig oder startet beim Mounten ohne ZustandsänderungReanimated CSS-Animation (animationName Keyframes)
Ein Element, das ein- oder ausgeblendet wird, oder eine Liste, die sich umordnetLayout-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 bauen
Ein Bottom Sheet, 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 Verhalten und Übergänge
Kontextmenü, Drücken-und-Halten-VorschauLink.Menu / Link.Preview (Expo Router, nur iOS) – native Menüs und Peek, nie in JS neu gebaut
Kopfzeile, die in einen großen Titel zusammenfälltheaderLargeTitleEnabled auf dem nativen Stack (nur iOS; headerLargeTitle ist veraltet) – kein Scroll-Worklet
Pull-to-RefreshRefreshControl – nur selbst bauen, wenn es eine signifikante Interaktion ist (siehe das Schwellenwert-Rezept)
UI, die der Tastatur folgtreact-native-keyboard-controller – die echte Position der Tastatur, Frame für Frame, auf dem UI-Thread
Vektorgrafik-Illustration, Feierlichkeit, LeerzustandLottie – nur für Illustration, niemals für UI-Zustand
Eine riesige animierte Szene, Freihandzeichnen@shopify/react-native-skia – eine Leinwand, wenn die Ansichtshierarchie selbst der Engpass ist

Greifen Sie nur zu einem geteilten Wert, wenn der Wert kontinuierlich oder unterbrechbar ist. Ein Drücken-Skalieren ist ein CSS-Übergang; ein Ziehen ist ein geteilter Wert. Die Verwendung eines Worklets für einen Zwei-Zustands-Umschalter ist das mobile Äquivalent zur Installation einer Bewegungsbibliothek für eine Einblendung.

Abhängigkeiten. Installieren Sie 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
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, benutzerdefinierte Zeichnung@shopify/react-native-skia

4. Wählen Sie die Eigenschaften

  • transform und opacity sind kostenlos. Alles andere ist ein Layout-Durchlauf. width, height, margin, padding, flex, top, left, gap führen Yoga für diesen Knoten und seine Geschwister bei jedem Frame neu aus.
  • Die eine Ausnahme: ein absolut positioniertes Element ohne Kinder – eine Tab-Pille, ein Fortschrittsbalken. Es ist aus dem Fluss genommen, also wird nichts anderes neu angeordnet, und das Animieren von width behält den Eckradius, den scaleX verschmieren würde.
  • Niemals scale(0). Beginnen Sie 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 das Verschieben skaliert. Halten Sie translate zuerst, es sei denn, Sie wollen die Multiplikation.
  • Android-Schatten sind elevation, und das Animieren von Elevation rendert den Schatten bei jedem Frame neu. Animieren Sie stattdessen die Opazität einer bereits mit Schatten versehenen Ebene.
  • Animieren Sie niemals die Intensität von BlurView. Auf Android rendert es die Unschärfe bei jedem Frame neu. Blenden Sie stattdessen die Opazität eines statischen BlurView über.
  • Prozentangaben funktionieren in 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, verwenden Sie eine Feder. Federn tragen Geschwindigkeit durch eine Unterbrechung; Timing-Kurven starten neu. Alles andere verwendet Timing.

Reanimateds Feder verwendet Apples zwei Designer-Parameter direkt – verwenden Sie diese Form, nicht Masse/Steifigkeit/Dämpfung:

InteraktionKonfiguration
Standard-Setzen, kein Überschwingen{ duration: 400, dampingRatio: 1 }
Neupositionieren / Zurückschnappen nach einem Zug{ duration: 400, dampingRatio: 0.8, velocity }
Sheet, Drawer{ duration: 300, dampingRatio: 0.8, velocity }
Darf eine harte Kante nicht überschreitenovershootClamping: true hinzufügen

Federn nur, wenn die Geste Schwung hatte. Überschwingen bei einem Menü, das eingeblendet wurde, fühlt sich falsch an; Überschwingen bei einer Karte, die Sie geworfen haben, fühlt sich richtig an.

Easing, für alles ohne Finger darauf:

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

Niemals ease-in auf der UI. Es beginnt langsam und verzögert den genauen Moment, den der Benutzer beobachtet. Die integrierten Easing-Funktionen von Reanimated sind so schwach wie die von CSS – verwenden Sie 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, DrawerFeder, ~300ms wahrgenommen
Bildschirmübergangder Plattform-Standard – nicht überschreiben

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

6. Halten Sie es vom JS-Thread fern

Dies ist die mobile-spezifische Kunst und der Punkt, an dem die meiste React Native-Bewegung stirbt.

  • Niemals setState von einem Gesten- oder Scroll-Handler aus aufrufen. Ein React-Render pro Frame ist die häufigste Ursache für Ruckeln in RN-Apps. Shared Value → useAnimatedStyle, und React rendert nie neu.
  • Niemals innerhalb von onUpdate oder einem Scroll-Handler zur RN-Laufzeit zurückplanen. scheduleOnRN(fn, ...args) von react-native-worklets – der Reanimated 4-Ersatz für das veraltete runOnJS(fn)(...args) – reiht einen RN-Laufzeit-Aufruf ein, 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 geteilten Wert während des Renderings lesen (translateY.get() in JSX). Es ist ein Schnappschuss, der nie aktualisiert wird, und er wird heimlich …

Individual skills in this repo

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

Asymmetric-al/core

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. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

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

Verwandte Skills