시각 디자인 명세의 기초: 디자인 토큰, 대비율, 색각 이상

2026-10-16 ~ 17에 메인테이너가 물었다: “@docs/02-ux-design\에는 글만 있던데 ux에는 디자인 요소는 정의하지 않는게 맞는건지요?” 그 답과, 시각 디자인 명세(04-visual-design)를 쓰며 나온 낱말을 정리한다.

한 줄 요약

UX 설계는 어떻게 움직이는가(조작 규칙)와 어떻게 보이는가(시각 디자인)를 함께 다룬다. 보이는 쪽은 색 · 선 · 글자 · 치수를 이름 붙은 값(토큰) 으로 정하고, 그 값이 누구에게나 읽히는지를 숫자(대비율, 색 차이) 로 보인다.

UX 문서에 시각 디자인이 들어가는가

들어간다. 그때까지 docs/02-ux-design에 글만 있었던 것은 시각 디자인 문서가 빠져 있었기 때문이다. 색과 굵기가 프로토타입의 코드 안에만 있었다.

  • 조작 규칙만 있으면 개발자는 “고른 블록을 표시한다”까지 안다. 어떤 색, 몇 px, 바탕을 칠하는지는 코드를 짜는 사람이 그때그때 정하게 된다.
  • 전문가가 시각 디자인 명세에서 찾는 것: 원칙(왜 이 색인가), 토큰, 글자 크기의 단계, 상태마다의 모습, 테마, 접근성 검증.

디자인 토큰

색이나 굵기를 코드에 바로 적지 않고 이름을 붙여 그 이름으로만 쓰는 것이다.

백엔드로 비유하면

설정 파일의 상수다. 코드 곳곳에 30을 적지 않고 TIMEOUT_SECONDS를 쓰면, 값을 한 곳에서 바꿀 수 있고 그 숫자가 무슨 뜻인지도 보인다.

토큰은 세 단계로 둔다.

단계예백엔드로 비유하면
원시ink.700 = #343b48값 자체 (상수 표)
의미text.primary → ink.900역할 이름 (인터페이스)
구성 요소fold.edge → ink.700한 모듈이 쓰는 설정

테마는 의미 토큰이 어느 원시 토큰을 가리킬지만 바꾼다. 어두운 테마에서 text.primary가 밝은 색을 가리키게 하면, 그 이름을 쓰는 코드는 고칠 것이 없다. 프로필(dev · prod)마다 같은 설정 키에 다른 값을 넣는 것과 같다. → model-layout-render-theme

대비율 (WCAG)

글자와 바탕의 밝기 차이를 1:1(같은 색) ~ 21:1(검정과 흰색)로 나타낸 수다. 웹 접근성 표준 WCAG 2.2가 셈하는 법과 기준을 정한다.

무엇기준
보통 글자4.5:1 이상
큰 글자, 뜻을 가진 선과 아이콘3:1 이상
  • 기준에 못 미치면 눈이 나쁜 사람, 햇빛 아래의 노트북, 싼 모니터에서 글자가 흐려진다.
  • 53번째 판에서 구조선 · 주석 · 숫자 · 펴 보인 글자의 색을 바꾼 것이 이 때문이다. 예전 색은 일부 바탕에서 기준에 닿지 않았다.
  • 계산은 journal/assets/2026-10-17-color-check.py가 한다.

색각 이상과 흑백

사람 열두 명에 한 명꼴(남성 기준)로 빨강과 초록을 잘 가리지 못한다. 그래서 색만으로 뜻을 전하지 않는다(원칙 2).

  • Chrome은 녹색맹 · 적색맹 · 청색맹 · 흑백으로 보이는 화면을 흉내 낼 수 있다(개발자 도구의 Rendering → Emulate vision deficiencies). 문서의 그림 넷이 이것으로 찍은 것이다.
  • 색 차이는 ΔE라는 수로 잰다. 2 아래면 거의 같은 색으로 보인다. If 바탕과 Event 바탕은 적색맹에게 1.1까지 가까워지지만, 빗금과 모자라는 모양이 달라 가려진다.
  • 흑백 밝기는 L*(0 검정 ~ 100 흰색)로 잰다. 인쇄나 흑백 화면에서 무엇이 진해 보일지 알 수 있다.

포커스 표시

키보드로만 쓰는 사람은 지금 어디에 있는지를 테두리로 본다(WCAG 2.4.7). 그래서 고른 블록이 없을 때도 캔버스 안쪽에 테두리를 그린다. 마우스로 누를 때는 그리지 않는다(:focus-visible). → browser-focus-and-double-click

claude.ai 페이지란

같은 세션에 “claude.ai 페이지라니 무엇을 말하는 것인가요?”라는 물음도 있었다. Claude가 만든 HTML을 claude.ai에 올린 아티팩트를 말한다. 주소가 생겨 브라우저와 휴대폰에서 열 수 있고, 처음에는 메인테이너만 볼 수 있다(공개는 메인테이너가 공유 메뉴에서). 저장소의 journal/assets/에 같은 파일의 사본이 있다. → sketchbook

더 읽을거리