| name | jwc-ui-shadcn-workflow |
| description | packages/ui의 shadcn/ui + Tailwind v4 컴포넌트를 추가/수정할 때 기존 컴포넌트 재사용, cn()/cva 패턴, exports 영향, lint/typecheck 절차를 따릅니다. |
UI (shadcn + Tailwind v4) Workflow
언제 사용하나요?
packages/ui/src/components/shadcn/*컴포넌트를 추가/수정할 때- className 병합, variants(cva), Radix 컴포넌트 조합을 해야 할 때
- exports 경로가 깨지지 않게 안전하게 변경하고 싶을 때
작업 원칙(요약)
- 새 컴포넌트 전에 기존 컴포넌트 재사용부터 검토
- className 조합은
cn()사용 - Tailwind class 정렬 경고가 있을 수 있으니
useSortedClasses를 염두 - 아이콘은
lucide-react만 사용(이모지 금지)
변경 절차
- 변경 범위 최소화
- 먼저 해당 파일/컴포넌트만 수정
- 스크립트로 shadcn 추가가 필요한 경우(선택)
pnpm -C packages/ui ui-add
- 패키지 검증
pnpm -C packages/ui lintpnpm -C packages/ui typecheck
exports 영향 체크
packages/ui/package.json#exports에 경로가 고정되어 있습니다.- 파일 이동/이름 변경은 소비측 import를 깨뜨릴 수 있으니, 변경 전후로 영향 범위를 확인합니다.
참고
- UI 상세 규칙: packages/ui/AGENTS.md
- 공통 규칙: AGENTS.md