Communitygithub.com

Grundlagen der Bewegung (Motion Foundations)

Bewegungstoken, Feder-Voreinstellungen, Leistungsregeln, Geräteanpassung, Barrierefreiheit und SSR-Sicherheit für React/Next.js mit motion/react. Grundlegende Schicht – alle anderen Bewegungsskills bauen darauf auf.

Was ist Grundlagen der Bewegung (Motion Foundations)?

Dieser Skill definiert die grundlegende Schicht des Bewegungssystems für React- und Next.js-Anwendungen unter Verwendung der Bibliothek motion/react. Er stellt alle Werte, Einschränkungen und Regeln bereit, die von nachgelagerten Skills wie motion-patterns und motion-advanced geerbt werden. Der Skill erzeugt ein gemeinsames motionTokens-Objekt (Dauer, Beschleunigung, Distanz, Skalierung), eine springs-Voreinstellungskarte mit fünf benannten Konfigurationen sowie eine shouldAnimate()-Funktion, die von allen Komponenten genutzt wird. Zudem werden barrierefreie Standardwerte über den useReducedMotion-Hook und SSR-sichere Initialzustände ohne Hydrierungswarnungen bereitgestellt. Zu den wichtigsten Regeln gehören die ausschließliche Verwendung von motion/react, die Anforderung, dass der initial-Prop mit dem Server-Output übereinstimmen muss, und die Außerkraftsetzung aller Animationen bei prefers-reduced-motion. Der Skill unterstützt Entscheidungen zur Auswahl von Dauern und Federn, gibt Richtlinien zum Deaktivieren von Animationen und enthält vollständige Codebeispiele für die Integration von Token, Zugänglichkeit und SSR-Schutz.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/503496348-ops/mischief-production/tree/HEAD/skills/ecc-motion-foundations

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Grundlagen der Bewegung (Motion Foundations)?

Die Basisschicht des Bewegungssystems. Definiert jeden Wert, jede Einschränkung und Regel, die von nachgelagerten Skills (motion-patterns, motion-advanced) geerbt werden. Lade diesen Skill, bevor du mit der Animationsarbeit beginnst.

Wann aktivieren

  • Wenn du eine animierte Komponente von Grund auf neu erstellst
  • Beim Einrichten von Token, Feder-Voreinstellungen oder Beschleunigungswerten
  • Bei der Implementierung von prefers-reduced-motion-Unterstützung
  • Beim Debuggen von Hydrierungskonflikten durch animierte Initialzustände
  • Bei der Bewertung, ob eine Animation überhaupt existieren sollte

Ausgaben

Dieser Skill erzeugt:

  • Ein gemeinsames motionTokens-Objekt (Dauer, Beschleunigung, Distanz, Skalierung)
  • Eine gemeinsame springs-Voreinstellungskarte (5 benannte Konfigurationen)
  • Eine shouldAnimate()-Schranke, die von allen Komponenten verwendet wird
  • Barrierefreie Animationsstandards über useReducedMotion
  • SSR-sichere Initialzustände ohne Hydrierungswarnungen

Grundsätze

Bewegung muss mindestens eines der folgenden Ziele erfüllen, sonst muss sie entfernt werden:

  • Aufmerksamkeit lenken
  • Zustand kommunizieren
  • Räumliche Kontinuität bewahren

Reaktionsfähigkeit hat immer Vorrang vor Geschmeidigkeit. Eine 60 fps-Animation, die eingabeverzögerungen verursacht, ist schlechter als keine Animation.

Regeln

Diese Regeln sind nicht verhandelbar. Sie gelten für jede Komponente im System.

  1. Verwende ausschließlich motion/react. Importiere niemals von framer-motion. Mische die beiden niemals im selben Baum.
  2. initial muss mit der Serverausgabe übereinstimmen. Wenn der Server opacity: 1 rendert, muss der initial-Prop ebenfalls opacity: 1 sein. Keine Ausnahmen.
  3. Reduzierte Bewegung überschreibt alles. Wenn useReducedMotion() true zurückgibt oder prefersReduced true ist, werden alle Transformationen deaktiviert. Nur Opazitäts-Fades mit ≤ 0,2 s sind als Fallback erlaubt.
  4. Layout-Eigenschaften niemals animieren. width, height, top, left, margin, padding sind in animate verboten. Verwende nur transform und opacity.
  5. Alle Token-Werte stammen aus motionTokens. Hartcodierte Dauern und Beschleunigungen in Komponentendateien sind verboten.
  6. Alle Feder-Konfigurationen stammen aus der springs-Map. Inline-stiffness/damping-Werte sind verboten.
  7. "use client" ist erforderlich in jeder Datei, die von motion/react importiert.
  8. Lese window oder navigator niemals auf Modulebene. Schütze sie immer mit typeof window !== "undefined".

Entscheidungshilfe

Auswahl einer Dauer

TokenVerwende, wenn
instantTooltip ein-/ausblenden, Fokusring, Badge-Update
fastButton-Feedback, Icon-Wechsel, Chip-Umschalten
normalModal öffnen, Karte erweitern, Seitenelement eintreten
slowHero-Eingang, vollständiger Seitenübergang
crawlBewusstes Storytelling; sparsam verwenden

Auswahl einer Feder

VoreinstellungVerwende, wenn
snappyStandard-UI — Buttons, Chips, Navigationselemente
gentleKarten, Modals, Panels, die sanft landen
bouncyVerspielte Momente — leere Zustände, Onboarding
instantTooltips, Popover, Dropdowns
releaseDrag-Freigabe — natürliches physikalisches Gefühl

Wann Animationen vollständig deaktivieren

Deaktiviere (mache shouldAnimate() zu false zurück), wenn:

  • prefersReduced ist true
  • isLowEnd ist true und die Animation ist nicht essenziell
  • Das Element ist außerhalb des Bildschirms und wird niemals in den Viewport gelangen
  • Die Animation ist rein dekorativ ohne UX-Zweck

Kernkonzepte

Token-System

// lib/motion-tokens.ts
export const motionTokens = {
  duration: {
    instant: 0.08,
    fast:    0.18,
    normal:  0.35,
    slow:    0.6,
    crawl:   1.0,
  },
  easing: {
    smooth: [0.22, 1, 0.36, 1],
    sharp:  [0.4, 0, 0.2, 1],
    bounce: [0.34, 1.56, 0.64, 1],
    linear: [0, 0, 1, 1],
  },
  distance: {
    xs: 4,
    sm: 8,
    md: 16,
    lg: 24,
    xl: 48,
  },
  scale: {
    subtle: 0.98,
    press:  0.95,
    pop:    1.04,
  },
}

export const springs = {
  snappy:  { type: "spring", stiffness: 300, damping: 30 },
  gentle:  { type: "spring", stiffness: 120, damping: 14 },
  bouncy:  { type: "spring", stiffness: 400, damping: 10 },
  instant: { type: "spring", stiffness: 600, damping: 35 },
  release: { type: "spring", stiffness: 200, damping: 20, restDelta: 0.001 },
}

Laufzeit-Flags

// lib/motion-config.ts
export const motionConfig = {
  isLowEnd() {
    return (
      typeof navigator !== "undefined" &&
      navigator.hardwareConcurrency <= 4
    )
  },

  prefersReduced() {
    return (
      typeof window !== "undefined" &&
      window.matchMedia("(prefers-reduced-motion: reduce)").matches
    )
  },

  shouldAnimate({ essential = false } = {}) {
    if (this.prefersReduced()) return false
    if (!essential && this.isLowEnd()) return false
    return true
  },

  duration() {
    return this.isLowEnd() || this.prefersReduced()
      ? motionTokens.duration.instant
      : motionTokens.duration.normal
  },
}

Barrierefreiheit

Prioritätsreihenfolge (höchste zu niedrigste):

  1. prefers-reduced-motion: reduce — deaktiviert alle Transformationen, begrenzt Opazitätsübergänge auf ≤ 0,2 s
  2. Erkennung von Geräten mit niedriger Leistung — reduziert die Dauer, entfernt nicht-essenzielle Animationen
  3. Designpräferenz — alles andere

Bewegung muss sich elegant verschlechtern. Sie darf niemals abrupt verschwinden, um Layoutverschiebungen zu verursachen oder die Orientierung zu verwirren.

// hooks/use-reduced-motion.tsx
"use client"
import { useReducedMotion } from "motion/react"

export function useSafeMotion(fullY: number = 16) {
  const reduce = useReducedMotion()
  return {
    initial: { opacity: 0, y: reduce ? 0 : fullY },
    animate: { opacity: 1, y: 0 },
    exit:    { opacity: 0, y: reduce ? 0 : -fullY },
  }
}
/* globals.css */
@media (prefers-reduced-motion: reduce) {
  .motion-safe-transition  { transition: opacity 0.15s; }
  .motion-reduce-transform { transform: none !important; }
}
<!-- Tailwind -->
<div class="motion-safe:animate-fade motion-reduce:opacity-100"></div>

SSR- / Hydrierungssicherheit

Regel: initial muss immer mit dem übereinstimmen, was der Server rendert.

// FALSCH — Server rendert opacity:1, aber initial sagt 0 → Hydrierungskonflikt
<motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} />

// RICHTIG — AnimatePresence verwenden oder auf Client-Mount verzögern
"use client"
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])

<motion.div
  initial={{ opacity: mounted ? 0 : 1 }}
  animate={{ opacity: 1 }}
/>

Codebeispiele

Durchgängiges Beispiel: Token + Federn + Barrierefreiheit + SSR-Schutz

// components/fade-in-card.tsx
"use client"

import { useState, useEffect } from "react"
import { motion } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"
import { useSafeMotion } from "@/hooks/use-reduced-motion"
import { motionConfig } from "@/lib/motion-config"

interface FadeInCardProps {
  children: React.ReactNode
  delay?: number
}

export function FadeInCard({ children, delay = 0 }: FadeInCardProps) {
  // SSR-Schutz — initial muss mit der Serverausgabe übereinstimmen (opacity: 1)
  const [mounted, setMounted] = useState(false)
  useEffect(() => setMounted(true), [])

  // Barrierefreiheit — deaktiviert Transformationen, wenn reduzierte Bewegung bevorzugt wird
  const safeMotion = useSafeMotion(motionTokens.distance.md)

  // Geräteschranke — Animation auf Geräten mit niedriger Leistung überspringen
  if (!motionConfig.shouldAnimate() || !mounted) {
    return <div>{children}</div>
  }

  return (
    <motion.div
      initial={safeMotion.initial}
      animate={safeMotion.animate}
      exit={safeMotion.exit}
      transition={{
        ...springs.gentle,
        delay,
      }}
      whileHover={{ scale: motionTokens.scale.pop }}
      whileTap={{ scale: motionTokens.scale.press }}
    >
      {children}
    </motion.div>
  )
}

Einschränkungen / Nicht-Ziele

Dieser Skill deckt nicht ab:

  • UI-Komponentenmuster (Button, Modal, Staffelung) → siehe motion-patterns
  • Drag, Gesten, SVG, Textanimationen, benutzerdefinierte Hooks → siehe motion-advanced
  • CSS-Only-Animationen oder Tailwind animate-*-Klassen ohne motion/react
  • Animationsbibliotheken von Drittanbietern (GSAP, anime.js usw.)
  • Entscheidungen im Bewegungsdesign (wann animieren, was hervorheben) — das ist eine Designfrage, keine Codeeinschränkung

Anti-Patterns

Anti-PatternVerletzte RegelKorrektur
import { motion } from "framer-motion"Regel 1motion/react verwenden
initial={{ opacity: 0 }} auf SSR-KomponenteRegel 2Mount-Schutz hinzufügen
useReducedMotion-Prüfung überspringenRegel 3useSafeMotion-Hook verwenden
animate={{ width: "100%" }}Regel 4Stattdessen scaleX-Transformation verwenden
transition={{ duration: 0.4 }} inlineRegel 5motionTokens.duration.normal verwenden
{ stiffness: 300, damping: 30 } inlineRegel 6springs.snappy verwenden
Fehlende "use client"-DirektiveRegel 7Oben in der Datei hinzufügen
navigator.hardwareConcurrency auf ModulebeneRegel 8In typeof navigator !== "undefined" kapseln

Verwandte Skills

  • motion-patterns — verbraucht hier definierte Token und Federn, um Button-, Modal-, Staffelungs-, Seitenübergangs- und Scrollmuster zu erstellen. Definiert keine Werte neu.
  • motion-advanced — verbraucht hier definierte Token und Federn für Drag-, SVG-, Text- und Gestenmuster. Fügt useAnimate-Sequenzen und benutzerdefinierte Hooks auf dieser Grundlage hinzu.

Individual skills in this repo

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

503496348-ops/mischief-production

Use this skill when inspecting Blender characters, rigs, poses, animation retargeting, ground contact, facing direction, or model-vs-motion alignment where screenshots alone are not enough.

503496348-ops/mischief-production

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider HCP video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

503496348-ops/mischief-production

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.

503496348-ops/mischief-production

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.

503496348-ops/mischief-production

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

503496348-ops/mischief-production

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

503496348-ops/mischief-production

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.

Verwandte Skills