토큰 정의 → 컴포넌트 props 분리 → Storybook 문서화 순으로 설명
팀 프로젝트에서 공통 UI 컴포넌트 라이브러리를 처음 만들었습니다. 버튼과 입력창을 여러 페이지에서 각자 만들다 보니 스타일이 제각각이어서 디자인 시스템 도입을 결정했습니다. 디자인 토큰을 CSS 변수로 먼저 정의하고 색상·간격·폰트 크기를 하나의 파일에 집중시켰습니다. 컴포넌트는 size와 variant props로 변형을 제어하도록 만들어서 새로운 디자인이 생겨도 코드 수정 없이 값만 바꾸면 되게 했습니다. 문서화는 Storybook으로 구성했고, 각 컴포넌트의 케이스를 눈으로 확인할 수 있어 디자이너와 협의하는 데 실질적으로 도움됐습니다. 버전 관리는 패키지로 분리해 semver 규칙을 따랐는데, 어디까지를 breaking change로 볼지 기준을 팀이 미리 정해두는 게 중요하다는 걸 배웠습니다.