Motion Dev 애니메이션
Motion.dev - 월 1,000만+ 다운로드, Framer Motion 후속 React, Next.js, Svelte, Astro, Vue를 위한 120fps GPU 가속 애니메이션
목적
Motion.dev를 사용해 애플/존 아이브 원칙을 따르는 프로덕션급 애니메이션 생성: 목적성(기능에 봉사) | 매끄러움(120fps) | 접근성(움직임 줄이기) | 성능(GPU 전용) | 우아함(미묘함) | 일관성(통일된 타이밍)
사용 시기
✅ 사용해야 할 때:
- React 19+/Next.js 15+/Svelte 5+/Astro 4+ 애니메이션 구현
- 스크롤 효과(패럴랙스, 표시), 제스처(호버, 드래그, 탭), 레이아웃 애니메이션
- 히어로 섹션, 카드, 60fps+ 성능이 필요한 마이크로 인터랙션
- 스프링 물리, 자연스러운 모션, 접근성이 필요한 프로젝트
❌ 사용하지 말아야 할 때:
- CSS 전용 전환(네이티브
transition속성 사용) - JavaScript 프레임워크 없는 정적 사이트
- Vue 프로젝트(
motion-v패키지 사용 - 다른 API) - SVG/Canvas 복잡한 애니메이션(GSAP이 더 적합)
- 폼 전용 CRUD 앱(과잉)
워크플로: 명확화 → 계획 → 구현 → 검증
1단계: 요구사항 명확화
프로젝트 맥락과 애니메이션 목표 파악:
- 프레임워크(React 19+, Next.js 15+, Svelte 5+, Astro 4+)
- 애니메이션 유형(진입, 제스처, 스크롤, 레이아웃)
- 디자인 목표(미묘함, 두드러짐, 유쾌함, 전문적)
- 성능 제약(대상 기기, 번들 제한, 접근성 요구사항)
- 트리거 메커니즘(마운트, 뷰포트, 사용자 상호작용)
2단계: 애니메이션 전략 계획
구현 접근 방식 정의:
- 애니메이션할 컴포넌트(헤더, 카드, 버튼, 섹션)
- 모션 패턴(페이드, 슬라이드, 스케일, 스프링, 패럴랙스)
- 타이밍 사양(지속 시간, 지연, 스태거 간격)
- 물리 매개변수(stiffness: 300-400, damping: 20, mass: 1)
- 접근성 대체(prefers-reduced-motion 대안)
3단계: 단계별 구현
점진적으로 애니메이션 구축:
- 설정: Motion.dev 설치, 임포트 구성, 컴포넌트 구조 준비
- 핵심 애니메이션: 모션 속성 적용(initial, animate, transition)
- 세부 조정: 자연스러운 느낌을 위한 타이밍, 이징 곡선, 스프링 물리 조정
- 접근성: 움직임 줄이기 감지 추가, 키보드 탐색 지원
- 최적화: GPU 가속 확인, 번들 크기 최소화, 성능 테스트
4단계: 품질 기준 검증
요구사항 대비 확인:
- 성능: ≥60fps(Chrome DevTools → Performance 탭)
- 레이아웃 안정성: CLS = 0(Lighthouse 감사)
- 접근성: prefers-reduced-motion 준수(시스템 설정 테스트)
- 키보드 탐색: 모든 상호작용 요소가 키보드로 접근 가능
- 모바일 반응형: 터치 친화적 제스처, iOS/Android에서 테스트
애니메이션 패턴 결정 트리
INPUT: 무엇이 애니메이션되어야 하나?
├─ 진입(페이지 로드, 마운트)
│ → 패턴: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}
│ → 타이밍: 0.6-0.8s, ease: [0.22, 1, 0.36, 1]
│ → 스태거: 요소 간 0.1-0.2s
│ → 예제: ./examples/hero-fade-up.md
│
├─ 제스처(호버, 탭, 드래그)
│ → 패턴: whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}
│ → 물리: 스프링(stiffness: 300-400, damping: 20)
│ → 타이밍: 즉각 응답(지속 시간 없음)
│ → 예제: ./examples/card-hover.md, ./examples/magnetic-button.md
│
├─ 스크롤(표시, 패럴랙스)
│ → 패턴: whileInView + viewport 또는 useScroll + useTransform
│ → 트리거: viewport={{once: true, amount: 0.3}}
│ → 성능: Transform/opacity만 사용
│ → 예제: ./examples/scroll-reveal.md, ./examples/parallax-layers.md
│
└─ 레이아웃(재정렬, 확장)
→ 패턴: layout prop(자동 FLIP)
→ 공유: layoutId="id"로 형태 변형
→ 주의: Transform만 애니메이션
API 빠른 참조
| 컴포넌트/훅 | 사용법 | 사용 시기 |
|---|---|---|
| motion.div | <motion.div animate={{x: 100}}> | 기본 애니메이션 |
| whileHover | whileHover={{scale: 1.05}} | 호버 상태(0.2-0.3s) |
| whileTap | whileTap={{scale: 0.95}} | 클릭 피드백 |
| whileInView | whileInView={{opacity: 1}} | 스크롤 표시 |
| drag | drag="x" dragConstraints | 드래그 가능 요소 |
| layout | <motion.div layout /> | 자동 FLIP 애니메이션 |
| useScroll | 스크롤 진행 추적 | 패럴랙스, 진행 막대 |
| useTransform | 값 매핑 | 스크롤 연결 효과 |
| useSpring | 스프링 물리 | 부드러운 값 변경 |
| useInView | 뷰포트 감지 | 애니메이션 트리거 |
전체 API: 완전한 API 참조 참조
프레임워크 통합
| 프레임워크 | 임포트 | 컴포넌트 | 종료 애니메이션 |
|---|---|---|---|
| React/Next.js | "motion/react" | <motion.div> | <AnimatePresence> |
| Svelte | "motion" | 바닐라 API | N/A |
| Astro | "motion" | 클라이언트 스크립트 | N/A |
| Vue | "motion-v" | <motion.div> | React와 유사 |
품질 기준
| 카테고리 | 요구사항 | 확인 방법 |
|---|---|---|
| 성능 | ≥60fps | Chrome DevTools → Performance |
| GPU 가속 | transform/opacity만 | width/height/left/top 없음 |
| 번들 | <50KB | webpack-bundle-analyzer |
| 접근성 | prefers-reduced-motion | 시스템 설정 테스트 |
| 모바일 | 터치 친화적 | iOS/Android 테스트 |
| 레이아웃 이동 | CLS = 0 | Lighthouse 감사 |
예제 라이브러리(점진적 로딩)
애니메이션 유형에 따라 필요 시 로드:
히어로 섹션
- 히어로 페이드 업 - 클래식 애플 스타일 진입
- 히어로 스태거 - 조율된 요소
- 히어로 분할 텍스트 - 문자 표시
스크롤 효과
제스처 및 상호작용
레이아웃 애니메이션
- 목록 재정렬 - 드래그하여 재정렬 FLIP
- 아코디언 - 확장/축소
- 탭 전환 - 공유 레이아웃
전체 예제: ./examples/ 디렉토리의 모든 파일
참조 문서(필요 시 로드)
- 완전한 API 참조 - 모든 컴포넌트, 훅, props
- 스프링 물리 가이드 - stiffness, damping, mass 조정
- 성능 최적화 - GPU, will-change, 지연 로딩
- 접근성 가이드 - 움직임 줄이기, 키보드, 스크린 리더
- 문제 해결 - 일반적인 문제, 해결책
- Framer Motion 마이그레이션 - 업그레이드 가이드
템플릿(프로덕션 준비 완료)
- Next.js 페이지 템플릿 - 히어로 + 특징 + 사용후기
- 컴포넌트 라이브러리 - 10개 이상 재사용 가능 컴포넌트
- 스크롤 템플릿 - 패럴랙스 + 표시 패턴
- 대시보드 템플릿 - 대화형 카드, 차트
설치
# React/Next.js/Svelte/Astro
npm install motion
# Vue
npm install motion-v
일반 패턴(복사-붙여넣기 준비 완료)
패턴 1: 페이드 업 진입
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }}
/>
패턴 2: 호버 카드
<motion.div
whileHover={{ y: -8, boxShadow: "0 20px 40px rgba(0,0,0,0.12)" }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
/>
패턴 3: 스크롤 표시
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.3 }}
/>
추가 패턴: 스태거 목록, 종료 애니메이션, 레이아웃 전환 → ./examples/ 디렉토리
오류 처리
| 문제 | 해결책 |
|---|---|
| 애니메이션이 트리거되지 않음 | initial ≠ animate 값인지 확인 |
| 성능 저하 | transform/opacity만 사용 + will-change CSS |
| 레이아웃 이동 | 명시적 크기 설정, layout prop 사용 |
| 종료가 작동하지 않음 | <AnimatePresence>로 래핑, key prop 추가 |
구현 모범 사례
- 단순하게 시작 → 페이드 + 슬라이드로 시작, 점진적으로 복잡성 추가
- 변형 추출 → 유지보수를 위해 애니메이션 상태를 명명된 변형으로 정의
- 스프링 물리 선호 → 기본적으로 스프링 전환 사용(tween보다 자연스러움)
- 목록 항목 스태거 → 리듬과 계층을 위해 staggerChildren(0.1-0.2s) 사용
- 모바일 철저히 테스트 → iOS/Android 기기에서 터치 제스처, 성능 확인
- 움직임 줄이기 포함 → 항상 prefers-reduced-motion 대체 애니메이션 제공
- 성능 프로파일링 → Chrome DevTools Performance 탭 사용, ≥60fps 목표
디자인 철학(애플/존 아이브 원칙)
모든 애니메이션에 다음 디자인 원칙 적용:
- 단순성: 200-400ms 지속 시간 사용, 동시 모션 최소화, transform 속성 선호
- 자연스러운 물리: 스프링 기반 전환 구현, 선형 이징 피하기, 질량 기반 움직임 적용
- 목적 있는 모션: 사용자 주의 유도, 상호작용 피드백 제공, 시각적 계층 구축
- 우아한 절제: "덜이 더다" 원칙 적용, 일관된 타이밍 유지, 사용자 모션 선호도 존중
검증
구조화된 출력 검증을 위해 다음 참조:
메타데이터
버전: 3.0.0(연구 기반 최적화) 최적화: 명령형 언어, 퓨샷 패턴(3개 예제), 계층적 복잡성, 점진적 로딩 토큰 효율: 핵심 87% 감소(15K → 2K) + 자동 캐싱 Motion.dev: v11+ 프레임워크: React 19+, Next.js 15+, Svelte 5+, Astro 4+, Vue 3+ 연구: arXiv 2402.07927v1, 2211.01910, 2310.14735v5, PubMed 40334089 라이선스: MIT