애니메이션 추가 (필수)
모든 컴포넌트에는 Framer Motion 애니메이션이 포함되어야 합니다.
APEX 워크플로우
0단계: 기존 애니메이션 분석
Task: explore-codebase
Prompt: "기존 Framer Motion 패턴 찾기: variants, timing,
easing, hover 효과. 애니메이션 규칙 보고."
규칙: 기존 애니메이션 패턴과 일치하거나 마이그레이션을 제안해야 합니다.
표준 패턴
컨테이너 + 스테거 (필수)
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}>항목 1</motion.div>
<motion.div variants={item}>항목 2</motion.div>
</motion.div>
호버 효과 (필수)
// 카드 호버
<motion.div whileHover={{ y: -4 }} transition={{ duration: 0.2 }}>
// 버튼 호버
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.98 }}
>
스크롤 애니메이션
<motion.div
initial={{ opacity: 0, y: 40 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: "-100px" }}
/>
타이밍 가이드라인
| 상호작용 | 지속 시간 | 이징(easing) |
|---|---|---|
| 호버 | 50-100ms | ease-out |
| 버튼 누름 | 100-150ms | ease-out |
| 모달 열림 | 200-300ms | ease-out |
| 페이지 전환 | 300-400ms | ease-in-out |
금지 사항
// ❌ 무작위 바운싱 루프
animate={{ y: [0, -10, 0] }}
transition={{ repeat: Infinity }}
// ❌ 과도한 효과
whileHover={{ scale: 1.2, rotate: 5 }}
// ❌ 느린 애니메이션
transition={{ duration: 1.5 }}
접근성 (필수)
import { useReducedMotion } from "framer-motion";
function Component() {
const shouldReduce = useReducedMotion();
return (
<motion.div
animate={shouldReduce ? {} : { y: 0 }}
transition={shouldReduce ? { duration: 0 } : { duration: 0.3 }}
/>
);
}
검증
[ ] 기존 애니메이션 분석 완료 (0단계)
[ ] 패턴이 기존과 일치하거나 마이그레이션 제안됨
[ ] 리스트/그리드에 스테거 적용
[ ] 모든 인터랙티브 요소에 호버 적용
[ ] prefers-reduced-motion 준수
[ ] 과도하거나 무작위적인 애니메이션 없음
참고 자료
- APEX 모션:
references/design/05-add-motion.md - 모션 패턴:
references/motion-patterns.md