Communitygithub.com

Motion System v4.2

Produktionsreifes UI-Bewegungssystem für React/Next.js. Verwenden für Animationen, Übergänge oder Bewegungsmuster.

Was ist Motion System v4.2?

Motion System v4.2 ist ein produktionsreifes, auf Performance, Barrierefreiheit und Benutzerfreundlichkeit ausgelegtes Bewegungssystem für React/Next.js-Anwendungen. Es basiert auf der Motion-Bibliothek (Nachfolger von Framer Motion) und bietet konsistente Patterns für Animationen, Übergänge und Bewegungsmuster. Das System stellt klare Richtlinien bereit: Bewegung soll Aufmerksamkeit lenken, Zustände kommunizieren oder räumliche Kontinuität bewahren – ansonsten sollte sie entfernt werden. Enthalten sind Motion-Tokens (Dauer, Easing, Distanz), Performance-Regeln (nur transform und opacity sind sicher), Geräteanpassung (Erkennung schwacher Hardware), Accessibility via useReducedMotion und CSS-Medienabfragen, sowie bewährte Architekturmuster für Hover, Tap, Scroll-Animationen und AnimatePresence-Modi (wait, sync, popLayout). Das System unterstützt React und Next.js (mit SSR-Safety-Hinweisen) und enthält vollständige Beispiele für Button-Interaktionen, Stagger-Listen, Modals (inkl. Focus Trap, Scroll Lock, Escape-Close), Parallax-Effekte und Skeleton-Loading.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/motion-ui

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Motion System v4.2?

Produktionsreifes UI-Bewegungssystem für React / Next.js.

Fokussiert auf Performance, Barrierefreiheit und Benutzerfreundlichkeit – nicht auf Dekoration.

Wann verwenden

Verwende dieses Bewegungssystem, wenn Bewegung:

  • Aufmerksamkeit lenkt (z. B. Onboarding, wichtige Aktionen)
  • Zustände kommuniziert (Laden, Erfolg, Fehler, Übergänge)
  • Räumliche Kontinuität bewahrt (Layout-Änderungen, Navigation)

Geeignete Szenarien

  • Interaktive Komponenten (Buttons, Modals, Menüs)
  • Zustandsübergänge (Laden → Geladen, Offen → Geschlossen)
  • Navigation und Layout-Kontinuität (Shared Elements, Crossfade)

Überlegungen

  • Barrierefreiheit: Reduzierte Bewegung immer unterstützen
  • Geräteanpassung: An schwache Geräte anpassen
  • Performance-Abwägungen: Reaktionsfähigkeit vor visueller Glätte priorisieren

Bewegung vermeiden, wenn

  • Sie rein dekorativ ist
  • Sie die Benutzerfreundlichkeit oder Klarheit verringert
  • Sie die Performance negativ beeinflusst

Wie es funktioniert

Kernprinzip

Bewegung muss:

  • Aufmerksamkeit lenken
  • Zustände kommunizieren
  • Räumliche Kontinuität bewahren

Wenn nichts davon zutrifft → entfernen.


Installation

npm install motion

Version

  • motion/react – Standard für aktuelle Motion for React-Projekte (Paket: motion)
  • framer-motion – Legacy-Importpfad für Projekte, die noch von Framer Motion abhängen

Nicht mischen. Das Mischen führt zu widersprüchlichen internen Schedulern und defekten AnimatePresence-Kontexten – Komponenten aus einem Paket koordinieren Exit-Animationen nicht mit Komponenten aus dem anderen.

So überprüfst du, welche Version dein Projekt verwendet:

cat package.json | grep -E '"motion"|"framer-motion"'

Immer konsistent aus einer Quelle importieren:

// Richtig (modern)
import { motion, AnimatePresence } from "motion/react"

// Richtig (Legacy)
import { motion, AnimatePresence } from "framer-motion"

// Niemals beide im selben Projekt mischen

Motion-Tokens

// motionTokens.ts
export const motionTokens = {
  duration: {
    fast: 0.18,
    normal: 0.35,
    slow: 0.6
  },
  // Verwende diese als `ease`-Wert in einem `transition`-Objekt:
  // transition={{ duration: motionTokens.duration.normal, ease: motionTokens.easing.smooth }}
  easing: {
    smooth: [0.22, 1, 0.36, 1] as [number, number, number, number],
    sharp:  [0.4,  0, 0.2, 1] as [number, number, number, number]
  },
  distance: {
    sm: 8,
    md: 16,
    lg: 24
  }
}

Anwendungsbeispiel:

import { motionTokens } from "@/lib/motionTokens"

<motion.div
  initial={{ opacity: 0, y: motionTokens.distance.md }}
  animate={{ opacity: 1, y: 0 }}
  transition={{
    duration: motionTokens.duration.normal,
    ease: motionTokens.easing.smooth
  }}
/>

Performance-Regeln

Sicher

  • transform
  • opacity

Vermeiden

  • width / height
  • top / left

Regel: Reaktionsfähigkeit > Glätte


Geräteanpassung

Die Heuristik kombiniert CPU-Kernanzahl und verfügbaren Arbeitsspeicher für ein zuverlässigeres Signal. deviceMemory ist auf Chrome/Android verfügbar; der Fallback deckt Safari und Firefox ab.

const isLowEnd =
  typeof navigator !== "undefined" && (
    // Wenig Arbeitsspeicher (nur Chrome/Android; undefined ansonsten → als leistungsfähig behandeln)
    (navigator.deviceMemory !== undefined && navigator.deviceMemory <= 2) ||
    // Wenige Kerne UND keine Memory-API (deckt Safari/Firefox auf schwacher Hardware ab)
    (navigator.deviceMemory === undefined && navigator.hardwareConcurrency <= 4)
  )

const duration = isLowEnd ? 0.2 : 0.4

Barrierefreiheit

JS (useReducedMotion)

import { motion, useReducedMotion } from "motion/react"

export function FadeIn() {
  const reduce = useReducedMotion()

  return (
    <motion.div
      initial={{ opacity: 0, y: reduce ? 0 : 24 }}
      animate={{ opacity: 1, y: 0 }}
    />
  )
}

CSS

@media (prefers-reduced-motion: reduce) {
  .motion-safe-transition {
    transition: opacity 0.2s;
  }

  .motion-reduce-transform {
    transform: none !important;
  }
}

Tailwind

<div class="motion-safe:animate-fade motion-reduce:opacity-100"></div>

Architektur & Patterns

Kern-Patterns

SzenarioPattern
Hover-FeedbackwhileHover
Tipp-/Drück-FeedbackwhileTap
Einblenden beim ScrollenwhileInView
Scroll-gebundener WertuseScroll + useTransform
Bedingtes Ein-/AusblendenAnimatePresence
Kleine Layout-Verschiebungen (ein Element, < ~300px Änderung)layout-Prop
Große Layout-Verschiebungen oder seitenweite Reflowslayout vermeiden; CSS-Übergänge oder seitenweites Routing verwenden
Komplexe, imperative SequenzenuseAnimate

Warum layout auf großen Containern vermeiden? Framer's Layout-Animation verwendet transform, um Positionen abzugleichen, aber bei Elementen, die den gesamten Viewport einnehmen oder tiefe Reflows auslösen, verursachen die Messkosten sichtbares Ruckeln und CLS. Bevorzuge CSS Grid/Flexbox-Übergänge oder koordiniere mit layoutId nur auf bestimmten Kind-Elementen.

Layout & Übergänge

  • Shared-Element-Übergänge → layoutId (muss pro gemounteter Instanz eindeutig sein)
  • Ein-/Aus-Übergänge → AnimatePresence (siehe mode-Hinweise unten)

AnimatePresence mode

Immer mode explizit angeben – der Standard ("sync") führt Ein- und Ausblenden gleichzeitig aus, was in den meisten UI-Mustern zu visuellen Überschneidungen führt.

modeWann verwenden
"wait"Ausblenden abgeschlossen, bevor Einblenden startet. Verwende für Modals, Toasts, Seitenübergänge.
"sync" (Standard)Ein- und Ausblenden überlappen sich. Nur verwenden, wenn Überlappung beabsichtigt ist (z. B. Crossfade-Karussells).
"popLayout"Ausgeblendetes Element wird sofort aus dem Layout entfernt; verbleibende Elemente animieren in die Lücke. Verwende für Listen, Tabs, schließbare Karten.
// Modal – immer "wait" verwenden
<AnimatePresence mode="wait">
  {open && <Modal key="modal" />}
</AnimatePresence>

// Schließbares Listenelement – "popLayout" verwenden
<AnimatePresence mode="popLayout">
  {items.map(item => <Card key={item.id} />)}
</AnimatePresence>

Fortgeschrittene Patterns (Konzepte)

  • Parallax (scroll-gebundene Transformationen)
  • Scroll-Storytelling (sticky Sections)
  • 3D-Neigung (zeigerbasierte Transformationen)
  • Crossfade (shared layoutId)
  • Progressive Enthüllung (clip-path)
  • Skeleton-Laden (wiederholte Opazität)
  • Mikro-Interaktionen (Hover/Tap-Feedback)
  • Feder-System (physikbasierte Bewegung)

Modal-Grundlagen

  • Focus Trap
  • Escape zum Schließen
  • Scroll Lock
  • ARIA-Rollen
  • AnimatePresence mode="wait" verwenden, damit die Exit-Animation abgeschlossen ist, bevor das nächste Modal eintritt

Vollständiges Beispiel

import React, { useEffect, useRef, useState } from "react"
import { motion, AnimatePresence } from "motion/react"

function useFocusTrap(ref: React.RefObject<HTMLDivElement | null>, active: boolean) {
  useEffect(() => {
    if (!active || !ref.current) return
    const el = ref.current
    const focusable = el.querySelectorAll<HTMLElement>(
      'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
    )
    const first = focusable[0]
    const last  = focusable[focusable.length - 1]

    function handleKey(e: KeyboardEvent) {
      if (e.key !== "Tab") return
      if (e.shiftKey && document.activeElement === first) {
        e.preventDefault()
        last?.focus()
      } else if (!e.shiftKey && document.activeElement === last) {
        e.preventDefault()
        first?.focus()
      }
    }

    el.addEventListener("keydown", handleKey)
    first?.focus()
    return () => el.removeEventListener("keydown", handleKey)
  }, [active, ref])
}

function useScrollLock(active: boolean) {
  useEffect(() => {
    if (!active) return
    const prev = document.body.style.overflow
    document.body.style.overflow = "hidden"
    return () => { document.body.style.overflow = prev }
  }, [active])
}

function Modal({ open, closeModal }: { open: boolean; closeModal: () => void }) {
  const ref = useRef<HTMLDivElement>(null)

  useFocusTrap(ref, open)
  useScrollLock(open)

  useEffect(() => {
    function onKey(e: KeyboardEvent) {
      if (e.key === "Escape") closeModal()
    }
    if (open) window.addEventListener("keydown", onKey)
    return () => window.removeEventListener("keydown", onKey)
  }, [open, closeModal])

  return (
    // mode="wait" stellt sicher, dass die Exit-Animation abgeschlossen ist, bevor ein neues Modal eintritt
    <AnimatePresence mode="wait">
      {open && (
        <motion.div
          role="dialog"
          aria-modal="true"
          aria-labelledby="modal-title"
          initial={{ opacity: 0 }}
          animate={{ opacity: 1 }}
          exit={{ opacity: 0 }}
          transition={{ duration: 0.2 }}
          className="fixed inset-0 flex items-center justify-center bg-black/40"
        >
          <motion.div
            ref={ref}
            initial={{ scale: 0.95, opacity: 0 }}
            animate={{ scale: 1,    opacity: 1 }}
            exit={{    scale: 0.95, opacity: 0 }}
            transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
            className="bg-white p-6 rounded"
          >
            <h2 id="modal-title">Dialog Title</h2>
            <button onClick={closeModal}>Close</button>
          </motion.div>
        </motion.div>
      )}
    </AnimatePresence>
  )
}

export function Example() {
  const [open, setOpen] = useState(false)

  return (
    <>
      <button onClick={() => setOpen(true)}>Open</button>
      <Modal open={open} closeModal={() => setOpen(false)} />
    </>
  )
}

SSR-Sicherheit

  • Anfängliche Zustände zwischen Server- und Client-Rendering abgleichen
  • Implizite Animationsursprünge vermeiden (immer initial explizit setzen)
  • Motion-Komponenten in Next.js App Router mit "use client" umschließen

Debugging

Prüfen:

  • Falscher Import (Mischen von motion/react und framer-motion)
  • Fehlende "use client"-Direktive im Next.js App Router
  • Fehlende key-Prop auf AnimatePresence-Kindern
  • Hydratationskonflikt (Anfangszustand unterscheidet sich zwischen SSR und Client)
  • layout-Prop-Fehlgebrauch auf großen Containern, der Reflow-Ruckeln verursacht
  • Zustandsgesteuerte Animation wird nicht ausgelöst (Abhängigkeitsarrays prüfen)

QA

  • Kein CLS
  • Tastatur funktioniert
  • Focus Trap in Modals
  • ARIA-Rollen korrekt (role="dialog", aria-modal="true")
  • Reduzierte Bewegung respektiert (useReducedMotion + CSS-Medienabfrage)
  • Keine Hydratationswarnungen in Next.js
  • Animationen stoppen sauber beim Unmount (keine Speicherlecks)
  • AnimatePresence mode explizit an allen Einsatzstellen gesetzt

Anti-Patterns

  • Layout-Eigenschaften animieren (width, height, top, left)
  • Unendliche Animationen ohne Zweck (immer fragen: welchen Zustand kommuniziert das?)
  • Übermäßiges Staffeln von Listen (staggerChildren ≤ 0.1s halten; darüber fühlt es sich langsam an)
  • Präferenzen für reduzierte Bewegung ignorieren
  • layout auf großen oder Vollbild-Containern verwenden
  • mode bei AnimatePresence weglassen (Standard "sync" verursacht visuelle Überlappung)
  • Bewegung rein aus dekorativen Gründen einsetzen

Philosophie

Bewegung ist Interaktionsdesign.


Abschließende Regel

Wenn Bewegung die UX nicht verbessert → entfernen.


Beispiele

Button-Interaktion

import { motion } from "motion/react"

export function Button() {
  return (
    <motion.button
      whileHover={{ scale: 1.02 }}
      whileTap={{ scale: 0.97 }}
      transition={{ duration: 0.15, ease: [0.4, 0, 0.2, 1] }}
    >
      Click me
    </motion.button>
  )
}

Beispiel mit reduzierter Bewegung

import { motion, useReducedMotion } from "motion/react"

export function FadeIn() {
  const reduce = useReducedMotion()

  return (
    <motion.div
      initial={{ opacity: 0, y: reduce ? 0 : 24 }}
      animate={{ opacity: 1, y: 0 }}
      transition={{ duration: reduce ? 0.1 : 0.35, ease: [0.22, 1, 0.36, 1] }}
    />
  )
}

Gestaffelte Liste

import { motion } from "motion/react"

const container = {
  hidden: {},
  visible: {
    transition: { staggerChildren: 0.08 } // ≤ 0.1s halten, um Trägheit zu vermeiden
  }
}

const item = {
  hidden:  { opacity: 0, y: 10 },
  visible: { opacity: 1, y: 0,  transition: { duration: 0.3, ease: [0.22, 1, 0.36, 1] } }
}

export function List() {
  return (
    <motion.ul variants={container} initial="hidden" animate="visible">
      {[1, 2, 3].map(i => (
        <motion.li key={i} variants={item}>Item {i}</motion.li>
      ))}
    </motion.ul>
  )
}

Modal mit AnimatePresence

import { motion, AnimatePresence } from "motion/react"

export function Modal({ open }: { open: boolean }) {
  return (
    <AnimatePresence mode="wait">
      {open && (
        <motion.div
          initial={{ opacity: 0, scale: 0.95 }}
          animate={{ opacity: 1, scale: 1    }}
          exit={{    opacity: 0, scale: 0.95 }}
          transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
        />
      )}
    </AnimatePresence>
  )
}

Scroll-Parallax

import { useScroll, useTransform, motion } from "motion/react"

export function Parallax() {
  const { scrollYProgress } = useScroll()
  const y = useTransform(scrollYProgress, [0, 1], [0, -80])

  return <motion.div style={{ y }} />
}

Skeleton-Laden

import { motion } from "motion/react"

export function Skeleton() {
  return (
    <motion.div
      className="bg-gray-200 h-6 w-full rounded"
      animate={{ opacity: [0.5, 1, 0.5] }}
      transition={{
        duration: 1.5,       // angenehmer Puls – fehlte, verursachte schnelles Blinken
        repeat: Infinity,
        ease: "easeInOut"
      }}
    />
  )
}

Shared Layout (Crossfade)

import { motion } from "motion/react"

// layoutId muss pro gemounteter Instanz eindeutig sein.
// Wenn mehrere Instanzen gleichzeitig existieren können, eine eindeutige ID anhängen:
// layoutId={`shared-${item.id}`}
export function Shared() {
  return <motion.div layoutId="shared" />
}

Individual skills in this repo

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

Cody-W-Tucker/skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, conversion rate, or landing page optimization.

Cody-W-Tucker/skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign.

Cody-W-Tucker/skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, Demand Gen, and Connected TV formats. Covers VAC→Demand Gen migration, Shorts creative requirements, and CTV shoppable ads. Use when user says YouTube Ads, video ads, pre-roll, bumper ads, YouTube campaign, Shorts ads, or CTV ads.

Cody-W-Tucker/skills

Craft the story that makes investors say \"I want in.\" Master the narrative structure that Reid Hoffman, Sequoia, and top founders use to raise capital. Use when: **Preparing to fundraise** to develop your story before the deck; **Investor meetings** to structure conversations that convert; **Pitch practice** to refine your narrative arc; **Cold outreach** to write compelling investor emails; **Pivoting** to reframe your story after a change

Cody-W-Tucker/skills

Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns.

Cody-W-Tucker/skills

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Cody-W-Tucker/skills

Optimize landing pages for maximum conversions using proven frameworks from Unbounce and Oli Gardner—apply the \"one goal, one message, one action\" principle with data-driven design, copy, and CTA best practices. Use when: **Create a new landing page** for a campaign; **Optimize an existing landing page** that isn't converting; **Review landing page design** before launch; **Improve form conversion rates** on lead gen pages; **A/B test landing page elements** systematically

Cody-W-Tucker/skills

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

Cody-W-Tucker/skills

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

Cody-W-Tucker/skills

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Cody-W-Tucker/skills

Production-ready animation patterns for React / Next.js — button, modal, toast, stagger, page transitions, exit animations, scroll, and layout — built on motion-foundations tokens and springs.

Cody-W-Tucker/skills

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Cody-W-Tucker/skills

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Cody-W-Tucker/skills

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Master April Dunford's 8-step sales narrative from \"Sales Pitch\" (2023). Transform your positioning into a compelling story that wins enterprise deals. Use when: Structuring B2B sales presentations and demos; Creating pitch decks for complex products; Training sales teams on narrative-driven selling; Converting positioning strategy into sales conversations; Winning against entrenched competitors

Cody-W-Tucker/skills

Swiss-style user-research narrative template in warm-paper editorial aesthetics. Use when users ask for a premium research deck or story-first live artifact with minimalist typography, high-clarity layout, subtle motion, donut breakdowns, and keyboard/click navigation across slides in a single HTML file.

Cody-W-Tucker/skills

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

Cody-W-Tucker/skills

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

Verwandte Skills