Communitygithub.com

Flutter Motion UI

Erstellen Sie anspruchsvolle, animierte Flutter-Oberflächen, bei denen Bewegung und Zustand gemeinsam gestaltet werden – inklusive Seitenübergänge, Hero/Shared-Element-Animationen, fließende Glas-Navigationsleisten, gestaffelte Eintritte, Bottom-Sheet-Bestätigungen, Slide-to-Confirm, OTP- und Multi-Schritt-Authentifizierungsflüsse, Lade-zu-Erfolg-Buttons, rollende Zahlen, animierte Listen-Insert/Remove, Live-Tracking-Bildschirme, Theme-Wechsel sowie State-Management (versiegelte Flusszustände, Single Source of Truth, optimistische Updates), das Bildschirme konsistent hält. Verwenden Sie dieses Skill, wenn der Nutzer darum bittet, einen Flutter-Bildschirm, ein Widget, einen Flow oder eine App (Splash, Onboarding, Auth, Home, Detail, Checkout, Profil, Lieferung, Ride-Sharing, Wallet, Fitness) zu bauen, zu designen, umzugestalten, zu animieren oder flüssiger/edler zu machen, oder Flutter-Übergänge, Hero, Glas-Morphismus/flüssiges Glas, Mikro-Interaktionen, UI-Konsistenz, Design-Tokens, ruckelige Animationen oder State-Management für UI (Riverpod, Bloc, Provider, chaotisches setState) erwähnt, selbst wenn sie das Wort „Animation“ nie sagen.

Was ist Flutter Motion UI?

Dieses Skill produziert Flutter-Bildschirme, die sich wie ein kohärentes, handgefertigtes Produkt anfühlen: Jedes Element erscheint mit Absicht, jede Berührung antwortet, jede Zustandsänderung ist sichtbar, und Daten bleiben über Bildschirme hinweg konsistent. Es wurde aus der frame-für-Frame-Analyse von 22 Referenz-App-Aufnahmen destilliert. Der Kernansatz ist, dass Zustand die Bewegung antreibt: Fast jeder ‚flüssige‘ Moment in den Referenzen ist der gleiche Mechanismus – ein Stück Zustand änderte sich, und die UI animierte vom alten zum neuen Wert. Die Arbeit besteht immer darin: (1) die Zustände des Bildschirms explizit zu modellieren (eine versiegelte Klasse, nicht fünf Booleans), (2) mit einem `switch` über diesen Zustand zu rendern, und (3) das, was sich ändert, in eine implizite Animation zu packen. Explizite `AnimationController` sind nur für fingergetriebene Gesten, Schleifen-Atmosphäre und choreografierte Mehrteil-Sequenzen reserviert. Das Skill enthält ein komplettes Motion-Kit mit Widgets für Eintritte, Seitenübergänge, Glas-Navigationsleisten, morphbare Buttons, Slide-to-Confirm, rollende Zahlen, OTP-Boxen und animierte Listen. Es betont Konsistenz durch Design-Tokens, die im Theme platziert werden, und einen hohen Code-Qualitätsstandard.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ismail554/flutter-motion-ui-skill/tree/HEAD/flutter-motion-ui

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Flutter Motion UI?

Dieses Skill produziert Flutter-Bildschirme, die sich wie ein kohärentes, handgefertigtes Produkt anfühlen: Jedes Element erscheint mit Absicht, jede Berührung antwortet, jede Zustandsänderung ist sichtbar, und Daten bleiben über Bildschirme hinweg konsistent.

Es wurde aus der frame-für-Frame-Analyse von 22 Referenz-App-Aufnahmen destilliert (Wallet, Lieferung, Ride-Sharing, Fitness, Auth/OTP, Alarm, Checkout, Buchung, Gerätekopplung). references/video-analysis.md listet auf, was jede Aufnahme tut und welches Rezept sie reproduziert.

Die Kernidee: Zustand treibt Bewegung

Nahezu jeder „flüssige“ Moment in den Referenzen ist der gleiche Mechanismus: Ein Stück Zustand änderte sich, und die UI animierte vom alten Wert zum neuen. Niemand hat controller.forward() aus einem Button-Handler aufgerufen. Die Arbeit besteht also immer aus:

  1. Modellieren Sie die Zustände des Bildschirms explizit (eine versiegelte Klasse, nicht fünf Booleans).
  2. Rendern Sie mit einem switch über diesen Zustand.
  3. Packen Sie das, was sich ändert, in eine implizite Animation (AnimatedSwitcher, AnimatedContainer, TweenAnimationBuilder oder ein Kit-Widget), sodass der Unterschied zwischen zwei Zuständen von selbst animiert.

Wenn dies erledigt ist, hören Animation und State-Management auf, zwei Probleme zu sein. Unterbrochene Animationen, Doppelklicks und „Lade-Spinner neben Erfolgs-Haken“-Bugs verschwinden, weil die unmöglichen Zustände nicht dargestellt werden können.

Explizite AnimationControllers sind für drei Dinge reserviert: fingergetriebene Gesten, Schleifen-Atmosphäre (Pulse, Scanner) und choreografierte Mehrteil-Sequenzen.

Arbeitsablauf

1. Lesen Sie das Projekt, bevor Sie etwas schreiben

  • pubspec.yaml: Flutter/Dart SDK, bereits verwendete State-Bibliothek (riverpod / bloc / provider / getx / keine), Router (go_router / auto_route / Navigator), vorhandene Animationspakete.
  • Vorhandenes Theme, Farben, Abstände, gemeinsame Widgets. Erweitern Sie das Vorhandene; führen Sie kein zweites Designsystem oder eine zweite State-Bibliothek ein. Passen Sie sich der Ordnerstruktur und Benennung des Projekts an. Halten Sie in einer bestehenden App Änderungen an Dateien, nach denen Sie nicht gefragt wurden, so klein wie die Funktion es erfordert (ein Hero-Wrapper, ein Abstandsinset), lassen Sie nicht angeforderte Lint- oder Stilbereinigungen in Ruhe, es sei denn, Sie werden darum gebeten, und listen Sie jede vorhandene Datei, die Sie umgeschrieben haben, in Ihrer Zusammenfassung auf, damit das Diff keine Überraschungen bereithält.
  • Wenn es sich um ein neues Projekt handelt oder keine Konventionen bestehen, verwenden Sie die Standards dieses Skills (Riverpod Notifier, Material 3 Theme mit Erweiterungen, lib/core/ + lib/features/<name>/).

2. Installieren Sie das Motion-Kit einmal

Kopieren Sie die vom Task benötigten Kit-Dateien in den gemeinsamen UI-Ordner des Projekts (Standard lib/core/motion/): immer motion.dart, plus nur die Widgets, die Sie tatsächlich verwenden werden, und schneiden Sie die Barrel-Datei entsprechend zu. Das Kopieren aller zehn Dateien für einen Bildschirm, der drei verwendet, hinterlässt dem Benutzer Code, den niemand aufruft. Das Kit ist reines Flutter ohne Abhängigkeiten, analyzer-sauber und widget-getestet. Wenn das Projekt bereits ein Äquivalent hat (eine eigene Dauerndatei, eine eigene Nav-Leiste), passen Sie sich diesem an, anstatt zu duplizieren.

DateiGibt Ihnen
motion.dartMotion.fast/base/slow/page/hero, Kurven, Federn, Reduced-Motion-Helfer – der einzige Ort, an dem Dauern leben; Haptics.tap/selection/success/error – der einzige Ort, an dem Haptik ausgelöst wird
entrance.dartEntrance (gestaffeltes Fade/Slide/Blur-In), StateSwitcher (animierter switch über Zustand)
page_routes.dartAppRoute, AppPageTransitions.theme(), showAppSheet, heroFadeShuttle
glass_nav_bar.dartGlassNavBar schwebende flüssige-Glas-Pille mit gleitendem Linsenindikator
morph_button.dartPressable, MorphButton (idle→spinner→success), AsyncMorphButton
slide_to_confirm.dartSlideToConfirm Drag-to-Commit mit Haptik und Status
rolling_number.dartCountUpText, RollingText (Tachometer-Ziffern)
otp_boxes.dartOtpBoxes, Shake
animated_items.dartAnimatedItems<T> – Liste, die Einfügungen/Entfernungen aus einer einfachen unveränderlichen Liste animiert

assets/examples/send_money_flow.dart ist ein vollständiger ausgearbeiteter Flow (Liste → Tastenfeld → Slide → Senden → Erfolg → Zurück, neue Zeile animiert herein). Lesen Sie ihn, wenn Sie einen Multi-State-Flow bauen; er ist das zu imitierende Muster. send_money_flow_test.dart daneben zeigt, wie man einen solchen Flow testet (voller Pfad, kleiner Bildschirmüberlauf, reduzierte Bewegung).

assets/project_setup/analysis_options.yaml ist der strenge Lint-Satz, den das Kit besteht. Bieten Sie an, ihn in die Analyzer-Konfiguration des Projekts zu mergen; überschreiben Sie keine Regeln, die ein Team bereits gewählt hat.

3. Designen Sie den Bildschirm als Zustände und Momente, dann bauen Sie

Bevor Sie einen Bildschirm codieren, notieren Sie sich (im Kopf oder als kurzen Kommentar):

  • Zustände: Was sind die unterschiedlichen Dinge, die dieser Bildschirm sein kann? (z. B. Editing → Submitting → Done | Failed)
  • Geteilte Daten: Was zeigt dieser Bildschirm, das auch ein anderer Bildschirm zeigt? Diese Daten bekommen einen Besitzer.
  • Momente: Eintritt, die primäre Aktion, jede Zustandsänderung und Austritt. Jeder bekommt eine bewusste Bewegung aus der Tabelle unten. Alles andere bleibt still.

Bauen Sie dann in dieser Reihenfolge: Tokens/Theme → statisches Layout → Zustandsschicht → Zustandsänderungs-Animationen → Eintritts-Staffelung → Navigationsübergang → Haptik → Reduced-Motion- und kleiner-Bildschirm-Check.

4. Verifizieren

Führen Sie dart format auf den von Ihnen bearbeiteten Dateien und flutter analyze aus, bis es sauber ist. Wenn ein Gerät/Emulator verfügbar ist, führen Sie die App aus und schauen Sie sich den Flow tatsächlich an; schreiben Sie andernfalls einen kurzen Widget-Test, der die Zustände durchläuft (sehen Sie sich die Form des Beispieltests an) und führen Sie ihn aus. Gehen Sie dann zu references/consistency-checklist.md.

Welche Bewegung für welchen Moment

MomentVerwenden SieTiming
Bildschirm erscheint zum ersten MalEntrance(index: n) auf 3–7 Top-Level-Blöcke, von oben nach untenslow, 55 ms Abstand
Push zu einem nicht verwandten Bildschirm (Splash→Home, Auth→App)AppTransition.fadeThroughpage
Nächster Schritt im selben Flow (Telefon→OTP→Passwort)AppTransition.sharedAxisX + animierter Schrittindikatorpage
Listeneintrag → sein DetailHero auf dem Bild/der Karte + Rest des Details fade in danach einhero
Bestätigen / Auswählen / Bewerten / AuswählenshowAppSheet, Inhalt gestaffelt darinpage
Anfrage in BearbeitungMorphButton oder SlideToConfirm mit statusbase pro Phase
Wert ändert sich (Preis, ETA, Guthaben)RollingText (diskret) / CountUpText (Größenordnung)base / long
Element hinzugefügt / entferntAnimatedItemsbase
Bildschirmzustand ändert sich (Loading→Content→Error)StateSwitcherbase
Auswahl (Chip, Karte, Tab, Stern)AnimatedContainer Farbe/Rand + kleines AnimatedScalefast
Jeder TippPressable Skalierung + leichte Haptikinstant
ValidierungsfehlerShake + roter Rand + Nachricht; Eingabe behaltenslow
ErfolgHaken poppt mit Motion.overshoot, halte successHold, dann weiter—

Faustregeln, die es geschmackvoll halten:

  • Eintritte spielen einmal. In trägen Listen würde eine Zeile, die beim Zurückscrollen in den sichtbaren Bereich neu aufgebaut wird, erneut animieren; übergeben Sie Entrance(enabled: …), sodass nur das erste Erscheinen animiert.
  • Ein Schaustück pro Navigation. Ein Hero oder ein Blur-Durch oder eine große Staffelung – nicht alle drei.
  • Langsam eintreten, schnell austreten. Austritte laufen mit ~60–80% der Eintrittsdauer mit Motion.exit.
  • Dinge, die zusammenhängen, bewegen sich zusammen; nicht zusammenhängende werden gestaffelt.
  • Animieren Sie Transform und Opacity; vermeiden Sie das Animieren von Layout in langen Listen. Unschärfe ist teuer – verwenden Sie sie auf wenigen Hero-Elementen, niemals pro Listenzeile.
  • Blockieren Sie niemals Eingaben für Dekoration. Eintritte dürfen die Tappbarkeit nicht verzögern; nur echte Arbeit (Netzwerk) deaktiviert Steuerelemente.
  • Beachten Sie reduzierte Bewegung: Das Kit reduziert bereits Dauern über Motion.of(context, …); machen Sie dasselbe in jedem Controller, den Sie schreiben.

State-Management-Grundlagen

Vollständiger Leitfaden mit Riverpod / Bloc / ChangeNotifier-Äquivalenten: references/state.md. Die nicht verhandelbaren Punkte:

  • Flow-Zustand ist eine versiegelte Klasse; UI ist ein erschöpfender switch. Tragen Sie die Daten, die jeder Zustand benötigt, darin.
  • Ein Besitzer pro Stück geteilter Daten. Ein Listenbildschirm und ein Detail-/Flow-Bildschirm lesen denselben Provider; der Flow schreibt darauf. Geben Sie keine Ergebnisse durch Navigator.pop zurück und patchen Sie eine lokale Kopie – so driften Bildschirme aus dem Sync.
  • Behalten Sie die Benutzereingabe bei Fehler. Fehlgeschlagenes Submit kehrt zum Bearbeitungszustand mit intakten Feldern plus einem Fehler zurück.
  • Seiteneffekte in Listenern, nicht in build. Navigation, Snackbars, Haptik reagieren auf Zustandsübergänge (ref.listen, BlocListener).
  • Animationszustand bleibt in Widgets; Geschäftszustand niemals. Ein Controller kennt Submitting; er weiß nichts über AnimationControllers.
  • Live-Daten sind ein Stream, der in Zustand gemappt wird (ETA, Fahrerposition, Bestellstatus), wobei das Widget zwischen den Ticks interpoliert, sodass die Bewegung kontinuierlich ist, selbst wenn Updates nur einmal pro Sekunde eintreffen.
  • Schützen Sie asynchrone Lücken (ref.mounted / isClosed / mounted), bevor Sie den Zustand nach einem await berühren.

UI-Konsistenz

Konsistenz ist das, was eine designete App von einem Haufen netter Bildschirme unterscheidet. Platzieren Sie Tokens im Theme und hardcoden Sie sie niemals in Widgets:

  • Farbe: ColorScheme + eine ThemeExtension für Markenextras (Erfolg, Glas-Tönung, Verläufe). Widgets lesen Theme.of(context); dies macht auch animiertes Hell/Dunkel-Switching kostenlos.
  • Abstände: Eine 4-Punkt-Skala (4, 8, 12, 16, 20, 24, 32). Ein horizontaler Seitenabstand für die gesamte App.
  • Radius: Drei Werte (z. B. 12 small / 20 card / 28 sheet) plus Pill. Gleiche Karte = gleicher Radius überall.
  • Typografie: Nur TextTheme-Rollen; tabellarische Ziffern für jede Zahl, die sich ändert.
  • Bewegung: Nur Motion.*.
  • Komponenten: Ein primärer Button, ein Sheet-Stil, ein Eingabestil, eine Nav-Leiste. Wenn eine zweite Variante erscheint, befördern Sie sie zu einem gemeinsamen Widget mit einem Parameter.

Details und die Audit-Liste: references/consistency-checklist.md.

Code-Qualitätsmaßstab

Animierte UI multipliziert die Kosten von schlampigem Code: eine Build-Methode, die 120 Mal pro Sekunde läuft, ein Controller, der seinen Bildschirm überlebt, ein Layout, das nur auf ein Telefon passt. Halten Sie jede Datei an denselben Maßstab wie das Kit. references/flutter-best-practices.md enthält die vollständige Anleitung; die Punkte, die am häufigsten schiefgehen:

  • Kleine Widget-Klassen, keine _buildX()-Helfermethoden, mit const-Konstruktoren – sodass ein Rebuild nur das berührt, was sich geändert hat.
  • Alles Erstellte wird disposet: Animation/Text/Scroll/Page-Controller, CurvedAnimations, Fokus-Nodes, Timer, Abonnements.
  • Schützen Sie jede asynchrone Lücke (context.mounted / ref.mounted / isClosed) und lassen Sie niemals ein Future still fallen (await oder unawaited).
  • Stabile Keys: ValueKey(item.id) in dynamischen Listen und auf AnimatedSwitcher-Children; niemals Index-Keys, niemals Keys, die in build erstellt wurden.
  • Layouts, die scrollen statt überlaufen: Jeder Bildschirm mit einem Tastenfeld, Formular oder Picker muss einen 320×480-Viewport, eine offene Tastatur und 1,3× Text überleben.
  • Jeder Bildschirm überlebt schmal + großer Text, nicht nur der Flow, nach dem Sie gefragt wurden: bei 320 breit und 1,6× Text läuft ein Row, das einen Titel und einen Betrag hält, eine Karte mit einer Zahl und einem Label oder eine Listen-Kachel seitlich über, es sei denn, der Text ist in Expanded/Flexible mit maxLines und overflow. Fügen Sie einen Test ein, der den ersten Bildschirm der App (und jeden Tab) bei 320×568 mit tester.platformDispatcher.textScaleFactorTestValue = 1.6 pumpt und keine Ausnahme erwartet.
  • Testen Sie die unglückliche Geste: einen früh losgelassenen Drag, einen zweiten Tipp während des Ladens, Zurück gedrückt während einer Anfrage. Diese Pfade enthalten die Abstürze, die ein Start-zu-Ende-Test nie berührt.
  • Keine Literale im Feature-Code: Farben, Radien, Abstände, Dauern, Haptik kommen alle aus Theme/Tokens/Motion/Haptics; benutzerseitige Strings folgen dem Lokalisierungs-Setup des Projekts.
  • Träge Listen und bereichsbezogene Rebuilds: Builder für alles Scrollbare, select für tickende Werte, statische Teilbäume, die als child übergeben werden.
  • Zugänglich von Grund auf: Semantik auf benutzerdefinierten Steuerelementen, eine Alternative für gestenbasierte Aktionen, reduzierte Bewegung beachtet. Ein Semantics(label: …, excludeSemantics: true)-Wrapper entfernt auch die Tipp-Aktion des Kindes – übergeben Sie onTap auch an das Semantics.
  • Getestet, wo es wichtig ist: Controller-Zustandsübergänge als Unit-Tests; ein Widget-Test pro Flow, der Ergebnisse bestätigt, nicht Animationsinterna.

Referenzdateien – lesen Sie die, die zur Aufgabe passt

  • references/motion-system.md – Tokens erklärt, Choreografie und Rezepte für Effekte, die nicht im Kit sind (Splash-Sequenzen, Blur-Fokus-In, Fortschrittsringe, Scanner-Linien, Farb-/Theme-Lerps, scroll-verbundene Header).
  • references/navigation-transitions.md – Seitenübergänge, Hero richtig gemacht, Container-Transform, Bottom-Sheets, Multi-Step-Flows, go_router-Integration.
  • references/glass-nav-bar.md – wie die flüssige-Glas-Leiste gebaut wird, Tuning, Leistung, Shell/Tab-Zustand, bekannte Fallstricke.
  • references/state.md – Flow-Zustände, geteilter Zustand, async/optimistische Muster, Live-Streams, in Riverpod, Bloc und ChangeNotifier.
  • references/components.md – Rezepte: Schrittfortschritt, auswählbare Karten/Chips, Sternbewertung mit reaktivem Label, Karten-Karussell, das die Seite neufärbt, Rad-Auswahlen, Skeletons, Live-Tracking-Sheet + Routenmarker, persistente Mini-Statusleiste.
  • references/video-analysis.md – die 22 analysierten Aufnahmen: was auf dem Bildschirm passiert und wie man es nachbaut.
  • references/flutter-best-practices.md – Projektstruktur, Widget-Komposition, Lebenszyklus, Async-Sicherheit, Dart 3-Gewohnheiten, robustes Layout, Leistung, Theming, l10n/Zugänglichkeit, Fehlerzustände, Testen, Tooling. Lesen Sie vor dem Erstellen einer neuen Projektstruktur oder beim Überprüfen/Refaktorieren vorhandenen Codes.
  • references/consistency-checklist.md – Tokens, QA vor der Auslieferung, Leistungs- und Zugänglichkeitsprüfungen.

Ausgabeerwartungen

  • Liefern Sie vollständige, ausführbare Dateien in der Projektstruktur – keine Fragmente mit „… Rest Ihres Codes“.
  • Verwenden Sie die vorhandenen Pakete des Projekts. Schlagen Sie ein neues Paket nur vor, wenn es seinen Platz klar verdient, und sagen Sie warum.
  • Flutter-APIs ändern sich schnell. Wenn das installierte SDK neuer ist, als Sie sich sicher sind, überprüfen Sie die Signatur (flutter analyze ist das schnellste Orakel), anstatt zu raten.
  • Teilen Sie dem Benutzer beim Beenden kurz mit, welche Momente animiert wurden und welche Zustandsform der Flow hat.

Verwandte Skills