Communitygithub.com

Motion Foundations

Jetons de mouvement, presets de ressorts, règles de performance, adaptation aux appareils, accessibilité et sécurité SSR pour React / Next.js avec motion/react. Couche fondamentale — toutes les autres compétences de mouvement en dépendent.

Qu'est-ce que Motion Foundations ?

Motion Foundations est la couche de base du système de mouvement pour React et Next.js utilisant la bibliothèque `motion/react`. Elle définit l'ensemble des valeurs, contraintes et règles que les compétences avancées (comme `motion-patterns` et `motion-advanced`) héritent et utilisent. Cette compétence produit un objet `motionTokens` partagé (durée, easing, distance, échelle), une carte de presets `springs` (5 configurations nommées), une fonction de garde `shouldAnimate()` qui respecte les préférences de mouvement réduit, des valeurs par défaut accessibles via `useReducedMotion`, et des états initiaux compatibles SSR sans avertissements d'hydratation. Les règles sont non négociables : utilisation exclusive de `motion/react`, correspondance stricte entre l'état initial et le rendu serveur, désactivation des animations lorsque `prefersReducedMotion` est actif, interdiction d'animer les propriétés de mise en page (width, height, etc.), utilisation obligatoire des tokens et des presets de ressorts, et directives pour la sécurité SSR et l'accessibilité. Cette compétence est conçue pour être chargée avant tout travail d'animation, garantissant une base cohérente et performante pour tous les composants animés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/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

Que fait Motion Foundations ?

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

Quand activer

  • Débuter un composant animé à partir de zéro
  • Mettre en place des jetons, des presets de ressorts ou des valeurs d'easing
  • Implémenter le support de prefers-reduced-motion
  • Déboguer les incohérences d'hydratation provenant des états initiaux d'animation
  • Évaluer si une animation doit exister

Résultats

Cette compétence produit :

  • Un objet motionTokens partagé (durée, easing, distance, échelle)
  • Une carte de presets springs (5 configurations nommées)
  • Une porte shouldAnimate() utilisée par tous les composants
  • Des valeurs par défaut d'animation accessibles via useReducedMotion
  • Des états initiaux compatibles SSR sans avertissements d'hydratation

Principes

Le mouvement doit remplir au moins l'un des objectifs suivants, sinon il doit être supprimé :

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

La réactivité prime toujours sur la fluidité. Une animation à 60 fps qui provoque un délai d'entrée est pire que pas d'animation du tout.

Règles

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

  1. Utiliser uniquement motion/react. Ne jamais importer depuis framer-motion. Ne jamais mélanger les deux dans le même arbre.
  2. initial doit correspondre à la sortie serveur. Si le serveur rend opacity: 1, la propriété initial doit également être opacity: 1. Aucune exception.
  3. Le mouvement réduit remplace tout. Lorsque useReducedMotion() renvoie true ou que prefersReduced est true, toutes les transformations sont désactivées. Les fondus d'opacité uniquement à ≤ 0.2 s sont la seule solution de repli autorisée.
  4. Ne jamais animer 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 ressorts proviennent de la carte springs. Les valeurs stiffness/damping en ligne sont interdites.
  7. "use client" est requis sur chaque fichier qui importe depuis motion/react.
  8. Ne jamais lire window ou navigator au niveau du module. Toujours protéger avec typeof window !== "undefined".

Guide de décision

Choisir une durée

JetonQuand l'utiliser
instantAffichage/masquage d'infobulle, anneau de focus, mise à jour de badge
fastRetour de bouton, changement d'icône, bascule de puce
normalOuverture de modale, expansion de carte, entrée d'élément de page
slowEntrée de héros, transition de page entière
crawlNarration délibérée ; à utiliser avec parcimonie

Choisir un ressort

PresetQuand l'utiliser
snappyUI par défaut — boutons, puces, éléments de navigation
gentleCartes, modales, panneaux atterrissant en douceur
bouncyMoments ludiques — états vides, intégration
instantInfobulles, popovers, menus déroulants
releaseRelâchement de glissement — sensation de physique naturelle

Quand désactiver complètement l'animation

Désactivez (faites en sorte que shouldAnimate() renvoie false) lorsque :

  • 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 élevé au plus bas) :

  1. prefers-reduced-motion: reduce — désactive toutes les transformations, limite les transitions d'opacité à ≤ 0.2s
  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 désoriente 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 → incohérence d'hydratation
<motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} />

// CORRECT — utiliser AnimatePresence ou différer 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 transformation lorsque le mouvement réduit est préféré
  const safeMotion = useSafeMotion(motionTokens.distance.md)

  // Porte de périphérique — 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 / Objectifs non couverts

Cette compétence ne couvre pas :

  • Les motifs de composants UI (bouton, modale, décalage) → voir motion-patterns
  • Le glissement, les gestes, 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 conception de mouvement (quand animer, quoi mettre en valeur) — c'est une préoccupation de conception, pas une contrainte de code

Anti-patrons

Anti-patronRègle violéeCorrectif
import { motion } from "framer-motion"Règle 1Utiliser motion/react
initial={{ opacity: 0 }} sur composant SSRRègle 2Ajouter une garde de montage
Ignorer la vérification useReducedMotionRègle 3Utiliser le hook useSafeMotion
animate={{ width: "100%" }}Règle 4Utiliser la transformation scaleX à la place
transition={{ duration: 0.4 }} en ligneRègle 5Utiliser motionTokens.duration.normal
{ stiffness: 300, damping: 30 } en ligneRègle 6Utiliser springs.snappy
Directive "use client" manquanteRègle 7Ajouter en haut du fichier
navigator.hardwareConcurrency au niveau du moduleRègle 8Encapsuler dans typeof navigator !== "undefined"

Compétences associées

  • 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 geste. Ajoute des séquences useAnimate et des hooks personnalisés par-dessus cette base.

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

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

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

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.

Skills associés