Animaciones Motion Dev
Motion.dev - Más de 10 millones de descargas/mes, sucesor de Framer Motion Animaciones aceleradas por GPU a 120 fps para React, Next.js, Svelte, Astro, Vue
Propósito
Generar animaciones de calidad profesional usando Motion.dev siguiendo los principios de Apple/Jon Ive: Intencionada (cumple una función) | Suave (120fps) | Accesible (movimiento reducido) | Rendimiento (solo GPU) | Elegante (sutil) | Consistente (temporización unificada)
Cuándo Usarlo
✅ Usar para:
- Implementación de animaciones en React 19+/Next.js 15+/Svelte 5+/Astro 4+
- Efectos de desplazamiento (parallax, revelado), gestos (hover, drag, tap), animaciones de diseño
- Secciones de héroe, tarjetas, microinteracciones que requieran rendimiento de 60fps+
- Proyectos que necesiten física de resorte, movimiento natural y accesibilidad
❌ No usar para:
- Transiciones solo CSS (usar la propiedad nativa
transition) - Sitios estáticos sin frameworks de JavaScript
- Proyectos Vue (usar el paquete
motion-v- API diferente) - Animaciones complejas SVG/Canvas (GSAP es más adecuado)
- Aplicaciones solo CRUD basadas en formularios (excesivo)
Flujo de trabajo: Aclarar → Planificar → Implementar → Verificar
Paso 1: Aclarar Requisitos
Determinar el contexto del proyecto y los objetivos de la animación:
- Framework (React 19+, Next.js 15+, Svelte 5+, Astro 4+)
- Tipo de animación (entrada, gesto, desplazamiento, diseño)
- Objetivo de diseño (sutil, destacado, divertido, profesional)
- Restricciones de rendimiento (dispositivo objetivo, límites de paquete, requisitos de accesibilidad)
- Mecanismo de activación (montaje, viewport, interacción del usuario)
Paso 2: Planificar la Estrategia de Animación
Definir el enfoque de implementación:
- Componentes a animar (encabezados, tarjetas, botones, secciones)
- Patrones de movimiento (desvanecer, deslizar, escalar, resorte, parallax)
- Especificaciones de temporización (duración, retraso, intervalos de escalonamiento)
- Parámetros físicos (rigidez: 300-400, amortiguación: 20, masa: 1)
- Alternativas de accesibilidad (prefers-reduced-motion)
Paso 3: Implementar en Fases
Construir animaciones de forma incremental:
- Configuración: Instalar Motion.dev, configurar importaciones, preparar la estructura del componente
- Animación Principal: Aplicar propiedades de movimiento (initial, animate, transition)
- Refinamiento: Ajustar temporización, curvas de easing, física de resorte para una sensación natural
- Accesibilidad: Agregar detección de movimiento reducido, soporte de navegación por teclado
- Optimización: Verificar aceleración por GPU, minimizar tamaño del paquete, probar rendimiento
Paso 4: Verificar Estándares de Calidad
Comprobar el cumplimiento de los requisitos:
- Rendimiento: ≥60fps (Chrome DevTools → pestaña Performance)
- Estabilidad del Diseño: CLS = 0 (auditoría Lighthouse)
- Accesibilidad: Respeta prefers-reduced-motion (prueba de configuración del sistema)
- Navegación por Teclado: Todos los elementos interactivos accesibles por teclado
- Responsive Móvil: Gestos táctiles, probado en iOS/Android
Árbol de Decisión de Patrones de Animación
INPUT: ¿Qué debería animarse?
├─ ENTRADA (carga de página, montaje)
│ → Patrón: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}
│ → Temporización: 0.6-0.8s, ease: [0.22, 1, 0.36, 1]
│ → Escalonamiento: 0.1-0.2s entre elementos
│ → Ejemplo: ./examples/hero-fade-up.md
│
├─ GESTO (hover, tap, drag)
│ → Patrón: whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}
│ → Física: Resorte (rigidez: 300-400, amortiguación: 20)
│ → Temporización: Respuesta instantánea (sin duración)
│ → Ejemplos: ./examples/card-hover.md, ./examples/magnetic-button.md
│
├─ DESPLAZAMIENTO (revelado, parallax)
│ → Patrón: whileInView + viewport O useScroll + useTransform
│ → Activación: viewport={{once: true, amount: 0.3}}
│ → Rendimiento: Solo transform/opacity
│ → Ejemplos: ./examples/scroll-reveal.md, ./examples/parallax-layers.md
│
└─ DISEÑO (reordenar, expandir)
→ Patrón: Propiedad layout (FLIP automático)
→ Compartido: layoutId="id" para transformación
→ Advertencia: Solo anima transformaciones
Referencia Rápida de API
| Componente/Hook | Uso | Cuándo |
|---|---|---|
| motion.div | <motion.div animate={{x: 100}}> | Animaciones básicas |
| whileHover | whileHover={{scale: 1.05}} | Estados hover (0.2-0.3s) |
| whileTap | whileTap={{scale: 0.95}} | Retroalimentación de clic |
| whileInView | whileInView={{opacity: 1}} | Revelado por desplazamiento |
| drag | drag="x" dragConstraints | Elementos arrastrables |
| layout | <motion.div layout /> | Animación FLIP automática |
| useScroll | Rastrear progreso de desplazamiento | Parallax, barras de progreso |
| useTransform | Mapear valores | Efectos vinculados al desplazamiento |
| useSpring | Física de resorte | Cambios de valor suaves |
| useInView | Detección de viewport | Activar animaciones |
API completa: Ver Referencia completa de la API
Integración con Frameworks
| Framework | Importación | Componentes | Animaciones de Salida |
|---|---|---|---|
| React/Next.js | "motion/react" | <motion.div> | <AnimatePresence> |
| Svelte | "motion" | API vanilla | N/A |
| Astro | "motion" | Scripts de cliente | N/A |
| Vue | "motion-v" | <motion.div> | Similar a React |
Estándares de Calidad
| Categoría | Requisito | Cómo Verificar |
|---|---|---|
| Rendimiento | ≥60fps | Chrome DevTools → Performance |
| Aceleración GPU | solo transform/opacity | Sin width/height/left/top |
| Paquete | <50KB | webpack-bundle-analyzer |
| Accesibilidad | prefers-reduced-motion | Prueba de configuración del sistema |
| Móvil | Táctil amigable | Pruebas en iOS/Android |
| Desplazamiento de diseño | CLS = 0 | Auditoría Lighthouse |
Biblioteca de Ejemplos (Carga Progresiva)
Cargar bajo demanda según el tipo de animación:
Secciones de Héroe
- Héroe Fade Up - Entrada clásica estilo Apple
- Héroe Escalonado - Elementos orquestados
- Héroe Texto Dividido - Revelado de caracteres
Efectos de Desplazamiento
- Revelado por Desplazamiento - Fade-in con Intersection Observer
- Capas Parallax - Profundidad multivelocidad
- Progreso de Desplazamiento - Indicador de lectura
Gestos e Interacciones
- Hover en Tarjeta - Elevación elegante + sombra
- Botón Magnético - Sigue al cursor
- Carrusel Arrastrable - Deslizador táctil
Animaciones de Diseño
- Reordenar Lista - FLIP con arrastre
- Acordeón - Expandir/contraer
- Cambio de Pestaña - Diseño compartido
Ejemplos completos: Todos los archivos en el directorio ./examples/
Documentación de Referencia (Carga Bajo Demanda)
- Referencia completa de la API - Todos los componentes, hooks, props
- Guía de Física de Resorte - Ajuste de rigidez, amortiguación, masa
- Optimización de Rendimiento - GPU, will-change, lazy loading
- Guía de Accesibilidad - Movimiento reducido, teclado, lectores de pantalla
- Solución de Problemas - Problemas comunes, soluciones
- Migración desde Framer Motion - Guía de actualización
Plantillas (Listas para Producción)
- Plantilla de Página Next.js - Héroe + características + testimonios
- Biblioteca de Componentes - Más de 10 componentes reutilizables
- Plantilla de Desplazamiento - Patrones parallax + revelado
- Plantilla de Panel - Tarjetas interactivas, gráficos
Instalación
# React/Next.js/Svelte/Astro
npm install motion
# Vue
npm install motion-v
Patrones Comunes (Listos para Copiar y Pegar)
Patrón 1: Entrada Fade Up
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }}
/>
Patrón 2: Tarjeta Hover
<motion.div
whileHover={{ y: -8, boxShadow: "0 20px 40px rgba(0,0,0,0.12)" }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
/>
Patrón 3: Revelado por Desplazamiento
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.3 }}
/>
Más patrones: Listas escalonadas, animaciones de salida, transiciones de diseño → directorio ./examples/
Manejo de Errores
| Problema | Solución |
|---|---|
| La animación no se activa | Verificar que initial ≠ animate valores |
| Bajo rendimiento | Usar solo transform/opacity + CSS will-change |
| Desplazamiento de diseño | Establecer dimensiones explícitas, usar la propiedad layout |
| La salida no funciona | Envolver con <AnimatePresence>, agregar la propiedad key |
Mejores Prácticas de Implementación
- Empezar simple → Construir desde fade + slide, agregar complejidad incrementalmente
- Extraer variantes → Definir estados de animación como variantes con nombre para mantenibilidad
- Preferir física de resorte → Usar por defecto transiciones de resorte (más naturales que tween)
- Escalonar elementos de lista → Usar staggerChildren (0.1-0.2s) para ritmo y jerarquía
- Probar móvil a fondo → Verificar gestos táctiles y rendimiento en dispositivos iOS/Android
- Incluir movimiento reducido → Siempre proporcionar alternativas de animación con prefers-reduced-motion
- Perfilar rendimiento → Usar la pestaña Performance de Chrome DevTools, apuntar a ≥60fps
Filosofía de Diseño (Principios de Apple/Jon Ive)
Aplicar estos principios de diseño a todas las animaciones:
- Simplicidad: Usar duraciones de 200-400ms, minimizar el movimiento simultáneo, preferir propiedades de transformación
- Física Natural: Implementar transiciones basadas en resortes, evitar easing lineal, aplicar movimiento basado en masa
- Movimiento Intencionado: Guiar la atención del usuario, proporcionar retroalimentación de interacción, establecer jerarquía visual
- Contención Elegante: Aplicar el principio "menos es más", mantener temporización consistente, respetar las preferencias de movimiento del usuario
Validación
Para validación de salida estructurada, ver:
- Esquema de Configuración de Motion - Esquema JSON
- Script de Validación - Comprobaciones automatizadas
Metadatos
Versión: 3.0.0 (Optimización Basada en Investigación) Optimización: Lenguaje imperativo, patrones few-shot (3 ejemplos), complejidad en capas, carga progresiva Eficiencia de Tokens: 87% de reducción central (15K → 2K) + auto-caching Motion.dev: v11+ Frameworks: React 19+, Next.js 15+, Svelte 5+, Astro 4+, Vue 3+ Investigación: arXiv 2402.07927v1, 2211.01910, 2310.14735v5, PubMed 40334089 Licencia: MIT