꾸비데브

내 사이트 디자인 정리: 색·글꼴·간격을 토큰으로 묶기

디자인 토큰과 CSS 변수를 구분하고 반복되는 색·글꼴·간격을 정리하는 방법입니다. 공통 값을 바꾼 뒤 여러 페이지와 화면 크기에서 확인할 기준도 설명합니다.

한 줄 요약

디자인 토큰은 색·크기 같은 디자인 결정을 이름 있는 값으로 관리하는 방법입니다. CSS 변수는 웹에서 이를 적용하는 수단 중 하나이며, 실제로 그 값을 참조한 요소에 변경이 반영됩니다.

AI에게 이렇게 시키기
이 사이트의 반복되는 색·글꼴·간격 값을 조사해 줘.
같은 역할의 값은 공통 토큰을 참조하게 정리하고, 서로 다른 역할은 무리하게 합치지 말아 줘.
수정 후 홈과 서브페이지, 좁은 화면, 버튼 상태와 키보드 포커스를 확인해 줘.

디자인 시스템을 적용한다는 것은 파일 하나를 만드는 것으로 끝나지 않습니다. 어떤 값이 어떤 역할을 맡는지 정하고, 실제 컴포넌트가 그 값을 사용하는지 확인하는 작업입니다.

Design Tokens Community Group 문서는 토큰을 사람이 읽을 수 있는 이름과 값에 연결된 정보로 정의합니다. CSS 사용자 지정 속성은 --이름으로 선언하고 var()로 참조할 수 있습니다. 두 개념은 연결되지만 같은 뜻은 아닙니다.

STEP 1

화면 문제를 먼저 기록하기

“예쁘게 바꿔 줘” 대신 “같은 버튼인데 높이가 다르다”, “본문 간격이 페이지마다 다르다”처럼 관찰한 문제를 적어 보세요. 아래 세 범위는 편집자가 제안하는 정리 시작점입니다.

디자인 정리 기준역할과 사용 범위를 정합니다색의 역할을 구분제목·본문의 글꼴 규칙여백은 규칙 있게 통일한 번에 한 가지씩 바꾸기
STEP 2

역할에 이름 붙이기

배경·본문·강조색, 제목·본문 글꼴, 요소 사이 간격처럼 역할을 구분합니다. 값이 우연히 같더라도 서로 다른 의미라면 무조건 하나로 합치지 않습니다. 색이나 글꼴을 몇 개만 써야 한다는 고정 법칙도 없습니다.

예를 들면 다음과 같이 CSS 변수를 적용할 수 있습니다. 값은 설명을 위한 예시입니다.

:root {
  --color-text: #1f1d1a;
  --color-surface: #fbf8f1;
  --space-content: 1.5rem;
}
.article {
  color: var(--color-text);
  background: var(--color-surface);
  padding: var(--space-content);
}
STEP 3

실제 참조를 연결하기

공통 값을 선언해도 컴포넌트에 색이 직접 적혀 있거나 다른 규칙이 덮어쓰면 반영되지 않습니다. 같은 역할의 반복 컴포넌트를 찾아 변수를 참조하도록 정리하세요. 필요한 범위에만 적용할 지역 변수도 사용할 수 있습니다.

직접 값과 공통 참조공통 값을 참조한 곳에 적용페이지마다공통 토큰톤 바꿀 때페이지 수만큼참조 범위 반영통일감깨지기 쉬움참조 여부 확인시안 비교번거로움같은 기준 비교

변경 후 확인할 화면

같은 버튼의 기본·눌림·비활성·포커스 상태, 긴 제목, 좁은 화면을 비교해 보세요. 홈 하나가 맞는다는 이유로 서브페이지도 맞다고 가정하지 않습니다. 토큰은 일관성을 관리하는 수단이며 접근성이나 사용성을 자동 보장하지 않습니다.

자주 묻는 질문

토큰 파일은 꼭 하나여야 하나요?

아닙니다. 역할과 규모에 따라 나눌 수 있습니다. 핵심은 같은 디자인 결정의 기준을 관리하고 참조 관계를 분명히 하는 것입니다.

CSS 변수만 넣으면 디자인 시스템인가요?

변수는 구현 수단입니다. 컴포넌트의 사용 규칙, 상태, 반응형 동작과 검수 기준도 함께 있어야 일관성을 확인할 수 있습니다.

한 번에 모두 바꿔야 하나요?

관련 값과 컴포넌트를 작은 묶음으로 정리하고 화면을 비교하는 방법을 제안합니다. 변경 범위와 검수 비용을 보고 순서를 정하세요.

확인한 공식 자료

확인일: 2026년 10월 15일. 아래 자료가 설명하는 기능과 이 글에서 제안하는 활용 방법을 구분했습니다.

함께 읽기

← BLOG 전체 보기무료자료 보기 →