Adicionando Animações (OBRIGATÓRIO)
Cada componente DEVE ter animações Framer Motion.
WORKFLOW APEX
Fase 0: ANALISAR ANIMAÇÕES EXISTENTES
Tarefa: explorar-código-fonte
Prompt: "Encontrar padrões de Framer Motion existentes: variantes, temporização,
easing, efeitos de hover. Relatar convenções de animação."
REGRIA: Corresponder aos padrões de animação existentes OU propor migração.
Padrões Padrão
Container + Stagger (OBRIGATÓRIO)
import { motion } from "framer-motion";
const container = {
hidden: { opacity: 0 },
show: { opacity: 1, transition: { staggerChildren: 0.1 } }
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 }
};
<motion.div variants={container} initial="hidden" animate="show">
<motion.div variants={item}>Item 1</motion.div>
<motion.div variants={item}>Item 2</motion.div>
</motion.div>
Efeitos de Hover (OBRIGATÓRIO)
// Hover em cartão
<motion.div whileHover={{ y: -4 }} transition={{ duration: 0.2 }}>
// Hover em botão
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.98 }}
>
Animação de Scroll
<motion.div
initial={{ opacity: 0, y: 40 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: "-100px" }}
/>
Diretrizes de Temporização
| Interação | Duração | Easing |
|---|---|---|
| Hover | 50-100ms | ease-out |
| Pressionar botão | 100-150ms | ease-out |
| Abrir modal | 200-300ms | ease-out |
| Transição de página | 300-400ms | ease-in-out |
PROIBIDO
// ❌ Loops aleatórios de quicar
animate={{ y: [0, -10, 0] }}
transition={{ repeat: Infinity }}
// ❌ Efeitos excessivos
whileHover={{ scale: 1.2, rotate: 5 }}
// ❌ Animações lentas
transition={{ duration: 1.5 }}
Acessibilidade (OBRIGATÓRIO)
import { useReducedMotion } from "framer-motion";
function Component() {
const shouldReduce = useReducedMotion();
return (
<motion.div
animate={shouldReduce ? {} : { y: 0 }}
transition={shouldReduce ? { duration: 0 } : { duration: 0.3 }}
/>
);
}
Validação
[ ] Animações existentes analisadas (Fase 0)
[ ] Padrões correspondem aos existentes OU migração proposta
[ ] Stagger em listas/grades
[ ] Hover em todos os elementos interativos
[ ] prefers-reduced-motion respeitado
[ ] Nenhuma animação excessiva/aleatória
Referências
- APEX Motion:
references/design/05-add-motion.md - Padrões de Movimento:
references/motion-patterns.md