Communitygithub.com

503496348-ops/mischief-production

Jetons de mouvement, préréglages de ressort, règles de performance, adaptation aux appareils, application de l'accessibilité et sécurité SSR pour React / Next.js avec motion/react. Couche fondamentale — toutes les autres compétences de mouvement dépendent de celle-ci.

Qu'est-ce que mischief-production ?

Cette compétence constitue la fondation du système de mouvement pour React et Next.js, définissant chaque valeur, contrainte et règle héritée par les compétences avancées `motion-patterns` et `motion-advanced`. Elle centralise un système de jetons (durées, easing, distances, échelles) et de préréglages de ressorts (snappy, gentle, bouncy, instant, release), fournissant une base cohérente pour toutes les animations. La compétence impose des règles strictes : utilisation exclusive de `motion/react` (jamais `framer-motion`), correspondance impérative entre l'état initial du serveur (SSR) et la prop `initial`, désactivation complète des transformées lorsque `prefers-reduced-motion` est activé, interdiction d'animer les propriétés de layout (width, height, etc.) au profit de `transform` et `opacity`. Elle intègre une fonction `shouldAnimate()` qui vérifie les préférences d'accessibilité, détecte les appareils bas de gamme (via `navigator.hardwareConcurrency`), et assure une sécurité SSR parfaite avec des hooks comme `useSafeMotion` qui évitent les erreurs d'hydratation. Le fichier `motion-config.ts` expose des flags d'exécution pour `isLowEnd()`, `prefersReduced()` et `shouldAnimate()`, tandis que les jetons sont définis dans `motion-tokens.ts`. Des exemples concrets montrent comment combiner jetons, ressorts et gardes d'accessibilité dans un composant `FadeInCard` prêt pour la production. Cette compétence ne couvre pas les motifs d'interface utilisateur (boutons, modales) ni les animations avancées (drag, SVG, texte), qui sont traités par les compétences dépendantes.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Fondations du Mouvement

La couche de base du système de mouvement. Définit chaque valeur, contrainte et règle que les compétences aval (motion-patterns, motion-advanced) héritent. Chargez cette compétence avant de commencer tout travail d'animation.

Quand Activer

  • Démarrer un composant animé de zéro
  • Mettre en place des jetons, des préréglages de ressort ou des valeurs d'easing
  • Implémenter le support de prefers-reduced-motion
  • Déboguer les désynchronisations d'hydratation provenant des états initiaux d'animation
  • Évaluer si une animation doit même exister

Livrables

Cette compétence produit :

  • Un objet motionTokens partagé (durée, easing, distance, échelle)
  • Un dictionnaire de présets springs (5 configurations nommées)
  • Une porte shouldAnimate() utilisée par tous les composants
  • Des valeurs par défaut d'animation conformes à l'accessibilité via useReducedMotion
  • Des états initiaux sûrs pour le SSR sans avertissements d'hydratation

Principes

Le mouvement doit remplir au moins l'une des conditions suivantes, sinon il doit être supprimé :

  • Guider l'attention
  • Communiquer un état
  • Préserver la continuité spatiale

La réactivité prime toujours sur la fluidité. Une animation à 60 fps qui provoque un délai de saisie est pire que l'absence d'animation.

Règles

Elles sont non négociables. Elles s'appliquent à chaque composant du système.

  1. Utilisez motion/react uniquement. N'importez jamais depuis framer-motion. Ne mélangez jamais les deux dans le même arbre.
  2. initial doit correspondre au rendu serveur. Si le serveur rend opacity: 1, la prop initial doit également être opacity: 1. Aucune exception.
  3. Le mouvement réduit remplace tout. Lorsque useReducedMotion() retourne true ou que prefersReduced est true, toutes les transformées sont désactivées. Les fondus en opacité uniquement à ≤ 0,2 s sont la seule solution de repli autorisée.
  4. N'animez jamais les propriétés de mise en page. width, height, top, left, margin, padding sont interdits dans animate. Utilisez uniquement transform et opacity.
  5. Toutes les valeurs des jetons proviennent de motionTokens. Les durées et easings codés en dur dans les fichiers de composants sont interdits.
  6. Toutes les configurations de ressort proviennent du dictionnaire springs. Les valeurs stiffness/damping en ligne sont interdites.
  7. "use client" est requis sur chaque fichier qui importe depuis motion/react.
  8. Ne lisez jamais window ou navigator au niveau du module. Protégez toujours avec typeof window !== "undefined".

Guide de Décision

Choisir une durée

JetonUtilisation
instantAffichage/masquage d'info-bulle, anneau de focus, mise à jour de badge
fastRetour de bouton, changement d'icône, bascule de chip
normalOuverture de modale, agrandissement de carte, entrée d'élément de page
slowEntrée de héros, transition de page complète
crawlNarration délibérée ; à utiliser avec parcimonie

Choisir un ressort

PréréglageUtilisation
snappyInterface utilisateur par défaut — boutons, chips, éléments de navigation
gentleCartes, modales, panneaux atterrissant en douceur
bouncyMoments ludiques — états vides, intégration
instantInfo-bulles, popovers, listes déroulantes
releaseRelâchement par glissement — sensation physique naturelle

Quand désactiver complètement l'animation

Désactivez (faites en sorte que shouldAnimate() retourne false) quand :

  • prefersReduced est true
  • isLowEnd est true et l'animation n'est pas essentielle
  • L'élément est hors écran et n'entrera jamais dans la zone d'affichage
  • L'animation est purement décorative sans objectif UX

Concepts Fondamentaux

Système de jetons

// 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 },
}

Indicateurs d'exécution

// 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
  },
}

Accessibilité

Ordre de priorité (du plus haut au plus bas) :

  1. prefers-reduced-motion: reduce — désactive toutes les transformées, limite les transitions d'opacité à ≤ 0,2 s
  2. Détection d'appareil bas de gamme — réduit la durée, supprime les animations non essentielles
  3. Préférence de conception — tout le reste

Le mouvement doit se dégrader gracieusement. Il ne doit jamais disparaître brusquement d'une manière qui provoque un décalage de mise en page ou perturbe l'orientation.

// 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>

Sécurité SSR / hydratation

Règle : initial doit toujours correspondre à ce que le serveur rend.

// FAUX — le serveur rend opacity:1 mais initial dit 0 → désynchronisation d'hydratation
<motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} />

// CORRECT — utilisez AnimatePresence ou différer jusqu'au montage client
"use client"
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])

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

Exemples de Code

De bout en bout : jetons + ressorts + accessibilité + garde SSR

// 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) {
  // Garde SSR — initial doit correspondre à la sortie serveur (opacity: 1)
  const [mounted, setMounted] = useState(false)
  useEffect(() => setMounted(true), [])

  // Accessibilité — désactive la transformée lorsque le mouvement réduit est préféré
  const safeMotion = useSafeMotion(motionTokens.distance.md)

  // Porte matérielle — ignorer l'animation sur le matériel bas de gamme
  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>
  )
}

Contraintes / Non-Objectifs

Cette compétence ne couvre pas :

  • Les motifs de composants d'interface utilisateur (bouton, modale, décalage) → voir motion-patterns
  • Le glissement, les gestes, le SVG, les animations de texte, les hooks personnalisés → voir motion-advanced
  • Les animations CSS uniquement ou les classes animate-* de Tailwind sans motion/react
  • Les bibliothèques d'animation tierces (GSAP, anime.js, etc.)
  • Les décisions de design de mouvement (quand animer, quoi mettre en valeur) — c'est une préoccupation de conception, pas une contrainte de code

Anti-Patterns

Anti-patternRègle violéeCorrection
import { motion } from "framer-motion"Règle 1Utilisez motion/react
initial={{ opacity: 0 }} sur un composant SSRRègle 2Ajoutez une garde de montage
Omission du contrôle useReducedMotionRègle 3Utilisez le hook useSafeMotion
animate={{ width: "100%" }}Règle 4Utilisez la transformée scaleX à la place
transition={{ duration: 0.4 }} en ligneRègle 5Utilisez motionTokens.duration.normal
{ stiffness: 300, damping: 30 } en ligneRègle 6Utilisez springs.snappy
Directive "use client" manquanteRègle 7Ajoutez-la en haut du fichier
navigator.hardwareConcurrency au niveau du moduleRègle 8Enveloppez avec typeof navigator !== "undefined"

Compétences Connexes

  • motion-patterns — consomme les jetons et ressorts définis ici pour construire des motifs de bouton, modale, décalage, transition de page et défilement. Ne redéfinit aucune valeur.
  • motion-advanced — consomme les jetons et ressorts définis ici pour les motifs de glissement, SVG, texte et gestes. Ajoute des séquences useAnimate et des hooks personnalisés sur cette fondation.

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.

Skills associés