Communitygithub.com

Sistema de Movimiento v4.2

Sistema de animación listo para producción en React/Next.js. Úsalo para implementar animaciones, transiciones y patrones de movimiento.

¿Qué es Sistema de Movimiento v4.2?

Motion System v4.2 es un sistema de animación profesional para React y Next.js, diseñado con un enfoque en rendimiento, accesibilidad y usabilidad, no en decoración. El skill proporciona pautas claras sobre cuándo usar movimiento (guiar la atención, comunicar estado, preservar continuidad espacial) y cuándo evitarlo (decoración pura, impacto negativo en rendimiento o usabilidad). Incluye tokens de movimiento predefinidos (duraciones, curvas de easing, distancias), adaptación a dispositivos de gama baja basada en núcleos de CPU y memoria, y soporte completo para accesibilidad con `useReducedMotion`. Cubre patrones avanzados como secuencias con `AnimatePresence`, animaciones de layout, parallax con scroll y transiciones compartidas mediante `layoutId`. El sistema es compatible con Next.js App Router (requiere `"use client"`) y recomienda importar exclusivamente desde `motion/react` para proyectos modernos. Incluye un modal completo con foco atrapado, cierre con Escape, bloqueo de scroll y roles ARIA, así como ejemplos prácticos de botones, listas escalonadas, skeletons y más.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Sistema de Movimiento v4.2?

Sistema de animación listo para producción para React / Next.js.

Centrado en rendimiento, accesibilidad y usabilidad — no en decoración.

Cuándo Usarlo

Usa este sistema de movimiento cuando el movimiento:

  • Guíe la atención (por ejemplo, tutoriales, acciones clave)
  • Comunique estado (carga, éxito, error, transiciones)
  • Preserve la continuidad espacial (cambios de diseño, navegación)

Escenarios Apropiados

  • Componentes interactivos (botones, modales, menús)
  • Transiciones de estado (cargando → cargado, abierto → cerrado)
  • Continuidad en navegación y diseño (elementos compartidos, fundido cruzado)

Consideraciones

  • Accesibilidad: Siempre soportar movimiento reducido
  • Adaptación a dispositivos: Ajustar para dispositivos de gama baja
  • Compensaciones de rendimiento: Preferir capacidad de respuesta sobre suavidad visual

Evitar Usar Movimiento Cuando

  • Es puramente decorativo
  • Reduce la usabilidad o claridad
  • Impacta negativamente el rendimiento

Cómo Funciona

Principio Central

El movimiento debe:

  • Guiar la atención
  • Comunicar estado
  • Preservar la continuidad espacial

Si no hace nada de esto → elimínalo.


Instalación

npm install motion

Versión

  • motion/react - predeterminado para proyectos Motion for React actuales (paquete: motion)
  • framer-motion - ruta de importación heredada para proyectos que aún dependen de Framer Motion

No mezclar. Mezclar causa planificadores internos conflictivos y contextos AnimatePresence rotos: los componentes de un paquete no coordinarán animaciones de salida con componentes del otro.

Para verificar qué versión usa tu proyecto:

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

Importa siempre de una sola fuente de manera consistente:

// Correcto (moderno)
import { motion, AnimatePresence } from "motion/react"

// Correcto (heredado)
import { motion, AnimatePresence } from "framer-motion"

// Nunca mezcles ambos en el mismo proyecto

Tokens de Movimiento

// motionTokens.ts
export const motionTokens = {
  duration: {
    fast: 0.18,
    normal: 0.35,
    slow: 0.6
  },
  // Úsalos como valor `ease` dentro de un objeto `transition`:
  // 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
  }
}

Ejemplo de uso:

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

Reglas de Rendimiento

Seguro

  • transform
  • opacity

Evitar

  • width / height
  • top / left

Regla: capacidad de respuesta > suavidad


Adaptación a Dispositivos

La heurística combina el número de núcleos de CPU y la memoria disponible para una señal más fiable. deviceMemory está disponible en Chrome/Android; la alternativa cubre Safari y Firefox.

const isLowEnd =
  typeof navigator !== "undefined" && (
    // Poca memoria (solo Chrome/Android; undefined en otros → tratar como capaz)
    (navigator.deviceMemory !== undefined && navigator.deviceMemory <= 2) ||
    // Pocos núcleos Y sin API de memoria (cubre Safari/Firefox en hardware débil)
    (navigator.deviceMemory === undefined && navigator.hardwareConcurrency <= 4)
  )

const duration = isLowEnd ? 0.2 : 0.4

Accesibilidad

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>

Arquitectura y Patrones

Patrones Principales

EscenarioPatrón
Retroalimentación al pasar el ratónwhileHover
Retroalimentación al tocar / presionarwhileTap
Revelar al hacer scrollwhileInView
Valor vinculado al scrolluseScroll + useTransform
Montaje/desmontaje condicionalAnimatePresence
Pequeños cambios de diseño (un solo elemento, < ~300px de cambio)Propiedad layout
Grandes cambios de diseño o reflujo de página completaEvitar layout; usar transiciones CSS o enrutamiento a nivel de página
Secuencias complejas e imperativasuseAnimate

¿Por qué evitar layout en contenedores grandes? La animación de layout de Framer usa transform para reconciliar posiciones, pero en elementos que abarcan todo el viewport o provocan un reflujo profundo, el costo de medición causa jank visible y CLS. Prefiere transiciones CSS Grid/Flexbox o coordina con layoutId solo en elementos hijos específicos.

Diseño y Transiciones

  • Transiciones de elementos compartidos → layoutId (debe ser único por instancia montada)
  • Transiciones de entrada / salida → AnimatePresence (ver guía de mode a continuación)

Modo de AnimatePresence

Especifica siempre mode explícitamente — el valor por defecto ("sync") ejecuta entrada y salida simultáneamente, lo que causa superposición visual en la mayoría de los patrones de interfaz.

modeCuándo usarlo
"wait"La salida se completa antes de que comience la entrada. Úsalo para modales, notificaciones, transiciones de página.
"sync" (por defecto)Entrada y salida se superponen. Úsalo solo cuando la superposición sea intencional (por ejemplo, carruseles con fundido cruzado).
"popLayout"El elemento que sale se elimina del flujo inmediatamente; los elementos restantes se animan para llenar el espacio. Úsalo para listas, pestañas, tarjetas descartables.
// Modal — siempre usar "wait"
<AnimatePresence mode="wait">
  {open && <Modal key="modal" />}
</AnimatePresence>

// Elemento de lista descartable — usar "popLayout"
<AnimatePresence mode="popLayout">
  {items.map(item => <Card key={item.id} />)}
</AnimatePresence>

Patrones Avanzados (Conceptos)

  • Parallax (transformaciones vinculadas al scroll)
  • Narrativa con scroll (secciones fijas)
  • Inclinación 3D (transformaciones basadas en el puntero)
  • Fundido cruzado (layoutId compartido)
  • Revelado progresivo (clip-path)
  • Carga con skeleton (opacidad en bucle)
  • Micro-interacciones (retroalimentación hover/tap)
  • Sistema de resorte (movimiento basado en física)

Esenciales de un Modal

  • Trampa de foco
  • Cierre con Escape
  • Bloqueo de scroll
  • Roles ARIA
  • Usar AnimatePresence mode="wait" para que la animación de salida se complete antes de que entre el siguiente modal

Ejemplo Completo

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" asegura que la animación de salida termine antes de que entre cualquier nuevo modal
    <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">Título del Diálogo</h2>
            <button onClick={closeModal}>Cerrar</button>
          </motion.div>
        </motion.div>
      )}
    </AnimatePresence>
  )
}

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

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

Seguridad SSR

  • Coincidir estados iniciales entre el renderizado del servidor y el cliente
  • Evitar orígenes de animación implícitos (siempre establecer initial explícitamente)
  • Envolver componentes motion en "use client" en Next.js App Router

Depuración

Verificar:

  • Importación incorrecta (mezclar motion/react y framer-motion)
  • Directiva "use client" faltante en Next.js App Router
  • Propiedad key faltante en hijos de AnimatePresence
  • Desajuste de hidratación (el estado inicial difiere entre SSR y cliente)
  • Mal uso de la propiedad layout en contenedores grandes que causa jank por reflujo
  • Animación impulsada por estado que no se activa (verificar arrays de dependencias)

QA

  • Sin CLS
  • El teclado funciona
  • Foco atrapado en modales
  • Roles ARIA correctos (role="dialog", aria-modal="true")
  • Movimiento reducido respetado (useReducedMotion + media query CSS)
  • Sin advertencias de hidratación en Next.js
  • Las animaciones se detienen limpiamente al desmontar (sin fugas de memoria)
  • mode de AnimatePresence establecido explícitamente en todos los puntos de uso

Anti-Patrones

  • Animar propiedades de diseño (width, height, top, left)
  • Animaciones infinitas sin propósito (preguntar siempre: ¿qué estado comunica esto?)
  • Escalonamiento excesivo de listas (mantener staggerChildren ≤ 0.1s; más allá se siente lento)
  • Ignorar preferencias de movimiento reducido
  • Usar layout en contenedores grandes o de viewport completo
  • Omitir mode en AnimatePresence (el valor por defecto "sync" causa superposición visual)
  • Usar movimiento puramente para decoración

Filosofía

El movimiento es diseño de interacción.


Regla Final

Si el movimiento no mejora la UX → elimínalo.


Ejemplos

Interacción de Botón

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] }}
    >
      Haz clic
    </motion.button>
  )
}

Ejemplo de Movimiento Reducido

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] }}
    />
  )
}

Lista Escalonada

import { motion } from "motion/react"

const container = {
  hidden: {},
  visible: {
    transition: { staggerChildren: 0.08 } // mantener ≤ 0.1s para evitar lentitud
  }
}

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}>Elemento {i}</motion.li>
      ))}
    </motion.ul>
  )
}

Modal con 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>
  )
}

Parallax con Scroll

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

Carga con Skeleton

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,       // pulso cómodo — faltaba, causaba un destello rápido
        repeat: Infinity,
        ease: "easeInOut"
      }}
    />
  )
}

Diseño Compartido (Fundido Cruzado)

import { motion } from "motion/react"

// layoutId debe ser único por instancia montada.
// Si pueden existir múltiples instancias simultáneamente, agrega un id único:
// 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.

Skills relacionados