컴포넌트 라이브러리는 UI API와 스타일 시스템을 함께 들여오는 결정이다
버튼과 모달을 빌리는 속도뿐 아니라 접근성, 테마 토큰, 번들 크기, 전역 CSS 충돌을 함께 계산한다.
| 검토 항목 | 확인할 것 | 통과 기준 | 위험 신호 |
|---|---|---|---|
| Components | Modal, Tabs, Dropdown, Toast | 필요한 상호작용 API가 충분함 | 프로젝트 요구와 API가 안 맞음 |
| Accessibility | focus trap, keyboard, ARIA | 키보드와 스크린리더 흐름이 동작 | 직접 보완해야 할 부분이 큼 |
| Design Token | color, spacing, radius, density | 브랜드 스타일로 무리 없이 매핑 | override가 복잡하거나 불가능 |
| Bundle/CSS | tree shaking, SSR, reset 충돌 | 필요한 코드만 들어옴 | 전역 스타일이 기존 UI를 깨뜨림 |
| Maintenance | 버전, 커뮤니티, 문서 | 업데이트와 버그 대응이 안정적 | 의존성이 오래 방치됨 |
UI 라이브러리는 화면을 자동 완성하는 도구가 아니라 컴포넌트 계약을 프로젝트에 도입하는 결정이다.