스킬: animate-ui
활성화 계약
다음 상황에서 이 스킬을 사용하세요:
- Animate UI 배포판을 사용하여 애니메이션 UI 컴포넌트를 추가하거나 커스터마이징할 때.
- shadcn/ui 프로젝트에서 Motion(Framer Motion) 기반 패턴을 구현할 때.
- Animate UI 레지스트리를 설정하거나 특정 프리미티브/컴포넌트를 추가할 때.
하드 규칙
- 복사 우선 접근 방식: 항상 컴포넌트를 고정된 라이브러리 임포트가 아닌 "열린 코드"로 취급하여 복사 및 수정해야 합니다.
- 종속성 확인: 컴포넌트를 추가하기 전에
motion,tailwind-merge,clsx,lucide-react가 설치되어 있는지 확인하세요. - 명명 규칙: shadcn CLI 명령어에 대해
@animate-ui/{category}-{sub-category}-{name}패턴을 따르세요. - 임포트 경로: 추가된 모든 컴포넌트와 프리미티브의 기본 경로는
@/components/animate-ui/를 사용하세요. - 표준 스택: React, Tailwind CSS, Framer Motion(Motion)을 사용하세요.
결정 게이트
| 작업 | 액션 |
|---|---|
| 새 프로젝트 | npx shadcn@latest init을 실행한 다음 Tailwind/Motion을 구성합니다. |
| 프리미티브 추가 | npx shadcn@latest add @animate-ui/primitives-{category}-{name}을 사용합니다. |
| 컴포넌트 추가 | npx shadcn@latest add @animate-ui/components-{category}-{name}을 사용합니다. |
| 커스텀 모션 | motion props(예: whileHover, transition)를 사용하여 기존 컴포넌트를 확장합니다. |
실행 단계
- 전제 조건 확인:
package.json에framer-motion(또는motion)과tailwind-merge가 있는지 확인합니다. - 초기 설정: 아직 완료되지 않은 경우
shadcn/ui초기화 프로세스를 따릅니다. - 컴포넌트 선택: 프리미티브(로직 + 기본 모션)가 필요한지, 컴포넌트(스타일이 적용된 UI 조각)가 필요한지 확인합니다.
- 설치:
@animate-ui범위의 패키지 이름과 함께 shadcn CLI를 사용합니다. - 통합:
@/components/animate-ui/...에서 가져와서 필요한 props를 전달합니다. - 다듬기: 스프링 전환(stiffness, damping)을 프로젝트 감성에 맞게 조정합니다.
출력 계약
- shadcn CLI를 통해 추가된 컴포넌트 목록.
- 구현에서 확인된 임포트 경로.
- 커스텀 모션 조정 사항이 있다면 그에 대한 설명.
참고 자료
references/getting-started.md— 설치 및 설정 가이드.references/components.md— 카테고리 및 명명 규칙.references/motion-patterns.md— 일반적인 스프링 및 전환 설정.