본문으로 건너뛰기
AZ Tools

컬러 토큰 익스포터

컬러 팔레트 한 번 정의 → CSS 커스텀 프로퍼티·Tailwind 설정·SCSS·LESS·디자인 토큰 JSON·SwiftUI Color·Android colors.xml로 익스포트. 라이브 미리보기 스워치.

프리셋:
토큰
미리보기
primary
primary-hover
surface
surface-muted
text
text-muted
border
danger
출력
:root {
  --color-primary: #3b82f6;
  --color-primary-hover: #2563eb;
  --color-surface: #ffffff;
  --color-surface-muted: #f5f5f5;
  --color-text: #111827;
  --color-text-muted: #6b7280;
  --color-border: #e5e7eb;
  --color-danger: #ef4444;
}

이름은 kebab-case로 정리. Hex는 #abc → #aabbcc 자동 확장.

사용법

  1. 프리셋 선택 또는 처음부터 팔레트 구성. 이름은 kebab-case로 정리됨.
  2. 스택에 맞는 프리픽스 설정: CSS엔 color, Tailwind엔 colors(또는 빈), 순수 $primary 원하면 SCSS엔 비우기.
  3. 포맷 전환. 복사. 스타일시트·테마 파일·에셋 카탈로그에 붙여넣기.

자세한 설명

펼치기

컬러 팔레트의 단일 진실 원천(SSOT), 어떤 스택에 배포하든 원클릭 익스포트. 이름과 hex(3·6·8자리)로 토큰 추가, 프리픽스 선택(color·brand·surface 등) → 선택한 포맷으로 출력 재생성. CSS는 :root 아래 --color-primary 커스텀 프로퍼티 제공. Tailwind는 tailwind.config.js에 붙여넣는 theme.extend.colors 블록. SCSS는 $color-primary 변수와 map.get 용 $colors 맵 둘 다. JSON은 Design Tokens Community Group { value, type } 형태. iOS는 SwiftUI Color 익스텐션, Android는 언더스코어 쓴 colors.xml 리소스 포맷. 프리셋으로 브랜드·중립 스케일·상태 컬러 시작 가능.

자주 묻는 질문

프리픽스 왜?

프리픽싱은 충돌 방지·의도 명확화. 스페이싱 토큰·라디우스 토큰 등도 있을 때 --color-primary가 --primary보다 가독성 좋음. Tailwind에선 토큰이 항상 extend.colors 아래로 감(Tailwind가 색상 유틸리티를 만드는 유일한 키) → 프리픽스는 그 안의 중첩 그룹이 됨. 프리픽스 brand면 bg-brand-primary. 프리픽스를 비우면 그냥 bg-primary.

Design Tokens JSON은 W3C 스펙 일치?

거의. 토큰당 { value, type: 'color' } 사용 → Design Tokens Community Group 초안과 일치. 엄격한 W3C 준수엔 그룹 객체 아래 중첩 필요할 수도 — 대부분 툴(Style Dictionary·Specify·Cobalt)은 플랫 형태 잘 처리하고 자체 변환 수행.

디자이너와 코드 양쪽에서 색이 바뀌는데 내보내기를 어떻게 맞춰두나?

한 곳을 기준으로 삼고 나머지는 그것에서 생성하라. 색이 두 형식에서 손으로 수정되는 순간부터 둘은 어긋나기 시작하고, 그 어긋남은 누군가 두 화면을 나란히 캡처하기 전까지 보이지 않는다. 원본 팔레트를 버전 관리에 두고, 플랫폼 파일은 빌드 단계에서 다시 생성하며, 손으로 고친 내보내기 결과물은 지름길이 아니라 버그로 취급하라.

토큰 이름은 어떻게 지어야 하나?

테마가 바뀔 수 있는 곳이라면 생김새가 아니라 역할로 지어라. blue-500이라는 토큰은 다크 모드에서 그 색이 더 밝아지는 순간 거짓말이 되지만, surface나 accent는 살아남는다. 문자 그대로의 색 이름은 바탕 팔레트로 두고 역할 토큰이 그것을 가리키게 하면 된다. 그 한 겹의 간접 참조 덕분에 이름을 바꾸지 않고도 테마를 갈아 끼울 수 있다.

관련 도구