실무에서 헷갈리지 않는 디자인 토큰(컬러 토큰) 이름 짓기 기준과 원칙
서론 디자인 시스템을 구축하거나 팀 프로젝트를 진행할 때, 디자이너와 개발자가 가장 먼저 부딪히는 난관 중 하나는 바로 색상의 이름을 정하는 일입니다. 처음에는 단순히 '파란색', '연한 파란색' 정도로 부르다가도, 프로젝트 규모가 커지고 테마가 복잡해지면 어느 순간 파란색만 수십 개가 넘어가는 상황에 직면하게 됩니다. 이때 도입하는 것이 바로 디자인 토큰, 그중에서도 컬러 토큰입니다. 하지만 토큰을 도입하더라도 이름을 어떻게 짓느냐에 따라 시스템의 확장성이 완전히 달라집니다. 일관성 없는 이름은 오히려 소통 비용을 증가시키고 다크 모드 같은 테마 확장을 불가능하게 만듭니다. 컬러 토큰의 이름을 정할 때 어떤 기준을 세워야 유지보수가 편해지고 구성원 모두가 직관적으로 사용할 수 있는지 그 구체적인 원칙을 살펴보겠습니다. 글로벌(기본) 토큰과 시맨틱(의미) 토큰의 명확한 분리 컬러 토큰 이름을 지을 때 가장 흔히 하는 실수는 '색상 자체의 이름'과 '그 색상이 쓰이는 용도'를 섞어서 사용하는 것입니다. 이를 방지하기 위해 실무에서는 보통 토큰을 두 가지 계층으로 나누어 설계합니다. 첫 번째는 시각적인 속성 자체를 정의하는 글로벌 토큰(또는 베이스 토큰)입니다. 여기서는 색상의 이름과 명도 단계를 결합하여 'blue-100', 'gray-900'과 같이 철저히 형태 중심적인 이름을 부여합니다. 두 번째는 실제 UI 요소에 적용될 때 사용하는 시맨틱 토큰입니다. 시맨틱 토큰은 글로벌 토큰을 참조하여 '어디에', '어떤 목적'으로 쓰이는지를 설명합니다. 예를 들어 'blue-500'이라는 글로벌 토큰을 'text-primary' 또는 'button-bg-action'이라는 시맨틱 토큰으로 연결하는 방식입니다. 이렇게 두 단계를 분리해야 브랜드 컬러가 파란색에서 보라색으로 바뀌더라도, 코드 상에서는 글로벌 토큰의 ...