디자인 토큰: 새 화면이 생겨도 유지되는 브랜드의 시각적 규칙 만들기
색, 간격, 타이포그래피의 역할에 이름을 붙이고 디자인 결정을 실제 웹사이트 요소의 변경까지 연결하는 방법을 살펴봅니다.
본문 언어: 한국어

목차
프로젝트 초기에 “이 빨간색이 조금 과한 것 같아요”라는 말은 충분히 이해할 수 있습니다. 하지만 스무 개의 화면을 구현한 뒤에는 수수께끼가 됩니다. 브랜드 색을 말하는 걸까요, 폼의 오류 색일까요, 프로모션 배경일까요, 아니면 삭제 버튼의 테두리일까요? 값 하나를 바꾸면 한 화면은 좋아지지만 전혀 다른 이유로 그 값을 쓰던 다른 세 화면은 망가질 수 있습니다.
디자인 토큰은 색, 간격, 텍스트 스타일처럼 다시 사용할 수 있는 결정에 이름을 붙인 것입니다. 이름이 역할을 설명할 때 특히 유용합니다. “오류 텍스트”는 그 값을 어디에 써야 하는지 알려줍니다. “빨강 3번”은 앞서 다른 빨간색 두 개를 골랐다는 사실만 주로 알려줍니다.
처음부터 방대한 시스템을 만들 필요는 없습니다. 계속 발전하는 웹사이트라면 디자이너와 개발자가 함께 이해하는 작은 결정 모음으로 시작할 수 있습니다. 무엇을 왜 바꾸는지, 변경 후 어디를 확인해야 하는지 답할 수 있어야 합니다. 이런 관계가 없는 값 목록은 혼란을 조금 더 깔끔하게 보관하는 방식에 그칠 수 있습니다.
값을 고르기 전에 역할부터 이름 붙이기
가상의 작업실 장비 판매점을 떠올려 보겠습니다. 이 브랜드는 짙은 빨강을 강조색으로 쓰는데, 주소 오류에도 비슷한 색이 나타납니다. 처음에는 둘 다 보기 좋습니다. 그런데 팀이 브랜드 색을 바꾸면 오류 메시지까지 새 색으로 바뀝니다. 메시지의 가독성을 바꾸기로 결정한 사람은 없는데도 말입니다.
문제는 서로 다른 역할에 하나의 값을 쓴 데 있습니다. 처음에는 같은 색조를 유지하더라도 브랜드 강조색과 오류 텍스트에 따로 이름을 붙일 수 있습니다. 그러면 나중에 둘을 반드시 함께 바꿀 필요가 없습니다. 두 역할을 계속 연결할지는 스타일시트의 우연이 아니라 명시적인 규칙으로 결정합니다.
세 가지를 구분해 보세요. 원래 값, 그 값의 역할, 특정 요소에서의 사용입니다. 원래 값은 색조이고, 역할은 “오류 메시지 텍스트”일 수 있으며, 요소는 주소 입력란 아래의 글입니다. 모든 속성에 세 단계의 이름이 필요한 것은 아니지만, 의존 관계를 연결하기 전에 그 차이를 이해하면 좋습니다.
Design Tokens Format Module 2025.10에서 별칭은 다른 토큰의 값을 참조하는 것을 뜻합니다. 이 보고서는 그런 참조로 의미 관계를 만드는 방법도 설명합니다. 결정들을 연결할 기술적 토대를 제공하지만, 브랜드에 맞는 이름이나 색상표를 대신 선택하지는 않습니다.
이 예시에서 각 작업용 이름에 역할과 변경 후 확인할 범위를 붙여 봅니다.
- 브랜드 강조색은 프로모션 콘텐츠를 돋보이게 합니다. 변경 후 제목, 링크와 제안 영역의 강조 요소를 살펴봅니다.
- 오류 텍스트는 입력란의 문제를 설명합니다. 배경 위에서 메시지가 잘 읽히는지 확인합니다.
- 오류 테두리는 입력란과 문제를 연결합니다. 입력란 상태와 주변 표시를 확인합니다.
- 입력란과 오류 사이의 간격은 입력 컨트롤과 안내문의 관계를 정합니다. 긴 텍스트와 확대된 화면을 확인합니다.
이는 대화를 정리하기 위한 제안이지 코드에 그대로 복사할 이름 목록은 아닙니다. 개발자는 다른 표기법을 선택할 수 있습니다. 두 표기 모두 같은 역할을 가리키고 사이트에서 대응하는 요소를 찾을 수 있어야 합니다.
현재 위치만으로 토큰의 이름을 정하지 마세요. “왼쪽 텍스트”는 레이아웃이나 언어가 바뀌면 금방 의미를 잃습니다. 공통 역할을 맡을 토큰을 한 화면의 이름으로 부르는 것도 피하세요. 이름은 요소가 이동해도 유효해야 하지만 무엇에나 들어맞을 만큼 막연해서는 안 됩니다.
결정에서 화면까지 변경 하나를 따라가 보기
팀이 오류 메시지를 장식적인 브랜드 강조색과 더 분명하게 구분하고 싶다고 가정해 봅시다. 먼저 이유를 정합니다. 폼을 작성하는 사람이 설명과 입력란을 쉽게 연결할 수 있어야 하고, 프로모션 제목은 경고처럼 보여서는 안 됩니다. 그다음에 해당 역할들의 값을 고릅니다.
디자이너는 오류 텍스트, 입력란 테두리, 그 사이의 간격을 지정합니다. 개발자는 어떤 요소들이 이 결정들을 사용하는지 확인합니다. 이 과정에서 직접 입력된 색이나 오래된 개별 스타일을 발견할 수 있습니다. 이를 시스템 밖에 남겨 두면 변경은 겉으로만 완성됩니다. 새 카드는 제대로 작동하지만 오래된 폼은 여전히 다른 시각적 언어를 보여 줍니다.
우연히 같은 값을 쓰는 요소도 살펴보세요. 오류 테두리가 보기 좋다는 이유로 프로모션 카드에 쓰였을 수 있습니다. 이제 그 테두리가 실제로 어떤 역할을 하는지 판단해야 합니다. 이름 없는 예외를 하나 더 추가하는 방식으로 해결하지 마세요. 예외 역시 디자인 결정이며 이유가 필요합니다.
변경 후에는 구체적인 상태를 확인합니다. 빈 입력란, 너무 긴 값, 입력값 수정, 다시 제출하기입니다. 텍스트가 여전히 입력란 곁에 들어맞나요? 테두리가 키보드 포커스 표시와 시각적으로 충돌하지 않나요? 메시지가 너무 일찍 사라지지는 않나요? 토큰은 값을 정리하지만 요소 전체의 동작을 시험하는 일을 대신하지는 않습니다.
영향을 살필 때 자주 방문하지 않는 곳도 고르세요. 펼쳐진 메뉴, 검색 결과 없음 메시지, 오류가 여러 번 발생한 폼이 그 예입니다. 공통 역할이 다른 주변 요소와 함께 나타날 수 있습니다. 흰 바탕에서 괜찮은 색이라도 자체 배경이 있는 패널에서 다시 확인해야 합니다. 이름은 이런 곳을 찾는 데 도움을 주지만, 평가는 해당 페이지 상태를 직접 열어 보아야 합니다.
아이콘 모음에도 역할이 있습니다. 사이트 아이콘의 의미와 라벨은 컨트롤이 무엇을 전달하는지 결정합니다. 토큰은 상태 색상이나 텍스트와의 간격을 유지할 수 있습니다. 하지만 적절한 이름 없이 알 수 없는 그림을 이해하기 쉽게 만들지는 못합니다. 아이콘의 의미와 이름에 관한 글 (폴란드어)에서 이 맥락을 더 살펴볼 수 있습니다.

오류가 없는 일반 상태도 확인하세요. 하나의 메시지를 위한 디자인 변경이더라도 공통 간격을 바꾸면 모든 입력란의 높이에 영향을 줄 수 있습니다. 검수 범위에는 결정을 내린 화면뿐 아니라 그 역할을 사용하는 곳이 포함되어야 합니다.
Aeneia Design 서비스에서는 공통 시각 규칙을 통해 성장하는 웹사이트를 더 쉽게 발전시킬 수 있습니다. 작업 전에 어떤 요소를 하나의 세트로 관리하고 이후 사용을 누가 책임질지 정하면 좋습니다.
시스템은 시안뿐 아니라 여러 조건에서 작동해야 합니다
Atlassian의 Forge 문서는 색, 간격, 타이포그래피 토큰과 앱 테마의 관계를 보여 줍니다. 특정 환경의 구현 사례일 뿐, 다른 모든 템플릿이 같은 라이브러리와 자동으로 호환된다는 뜻은 아닙니다.
기업 웹사이트에서는 실제로 존재하는 변형부터 정하세요. 라이트 화면과 다크 화면이 있다면 같은 텍스트 역할도 배경에 따라 다른 값이 필요할 수 있습니다. 기업 웹사이트의 다크 모드를 단순히 색 몇 개를 반전하는 일로 줄이지 마세요. 콘텐츠, 표면, 테두리와 상태의 관계를 함께 살펴야 합니다. 관련 과정은 다크 모드의 도입과 점검에 관한 글 (폴란드어)을 참고하세요.
여러 제품군이나 서비스군을 가진 브랜드라면 공통 역할과 구별되는 특징을 나누세요. 제품군의 강조색이 달라지더라도 오류 텍스트의 성격까지 바뀔 필요는 없습니다. 브랜드 구조와 제품 이름에서는 먼저 제공 항목들 사이의 관계를 명확히 합니다. 시각 시스템은 그 관계를 보여 주어야지 새로운 구분 단계를 독자적으로 만들어서는 안 됩니다. 관련 관점은 브랜드와 제공 항목 이름의 관계에 관한 글 (폴란드어)에서도 다룹니다.
눈에 보이는 간격마다 반복되는지 확인하지 않고 별도 토큰을 만들지 마세요. 필요한 것은 라벨과 입력란 사이, 입력란끼리, 섹션 사이처럼 알아볼 수 있는 몇 가지 관계입니다. 이름은 정한 간격 척도와 역할을 반영할 수 있습니다. 거의 같은 값이 백 개 있으면 규칙이 없는 경우만큼 결정을 어렵게 만듭니다.
타이포그래피에도 비슷한 원칙이 필요합니다. 제목 스타일에는 크기뿐 아니라 사용 방식, 간격, 긴 내용에서의 동작이 포함됩니다. 웹사이트 타이포그래피 시스템은 문구가 바뀌어도 위계를 유지해야 합니다. 시안에 들어가지 않는다는 이유만으로 개별 제목 하나를 줄이는 데 토큰을 써서는 안 됩니다. 시스템이 데이터를 포함한다면 임의의 강조색을 배정하기보다 브랜드 차트의 색, 라벨과 척도 역할도 정하세요. 관련 질문은 웹사이트 타이포그래피에 관한 글 (폴란드어)에서 확인할 수 있습니다. 브랜드의 차트 표현에 관한 글 (폴란드어)도 함께 살펴보세요.
예외가 타당할 때도 있습니다. 캠페인에 별도 강조색을 쓰거나 특수 모듈에 다른 간격 리듬을 적용할 수 있습니다. 예외의 범위와 공통 규칙과의 관계를 기록하세요. 그러면 다음 화면이 한 행사만을 위한 해결책을 우연히 물려받지 않습니다. 가장 오래 남는 예외 중에는 아무도 임시라고 부르지 않은 것들이 있습니다.
쇼핑몰 거래 안내 메시지에서는 공통 역할이 브랜드의 성격을 유지하는 데 도움이 되지만, 기술적 사용 방식은 따로 확인해야 합니다. 같은 디자인이라도 이메일 템플릿과 웹페이지를 다르게 준비해야 할 수 있습니다. 시각 원칙은 같지만 값을 전달하는 방법은 환경에 따라 달라집니다. 쇼핑몰 거래 안내 메시지에 관한 글 (폴란드어)에서는 시각적 위계가 다음 행동을 어떻게 돕는지 살펴봅니다.
작더라도 실제로 쓰는 세트부터 시작하기
이미 운영 중인 사이트라면 모든 컴포넌트를 한꺼번에 다시 작성할 필요는 없습니다. 실제로 확장 중이거나 문제가 있는 영역을 고르세요. 상품 소개 카드 모음, 폼, 내비게이션이 될 수 있습니다. 현재 값을 적고 역할에 이름을 붙인 뒤 어떤 차이가 의도된 것인지 정합니다. 정리 순서는 그다음에 결정합니다.
기존 방식에서 새 방식으로 옮기는 과정에서는 기존 이름과 새 이름을 연결한 표를 남기세요. 오래된 스타일을 폐기할 때는 대체 항목과 확인이 필요한 곳을 지정합니다. 이름을 없애기만 하면 게시 후에야 문제가 드러날 수 있습니다. 문서를 보면 개발자가 변경 의도를 이해할 수 있어야 합니다.
현재 유효한 결정의 출처를 하나로 정하거나 명확한 동기화 절차를 합의하세요. 디자인과 코드는 서로 다른 도구를 쓸 수 있지만, 같은 규칙의 다른 버전을 차이를 표시하지 않은 채 여러 주 동안 유지해서는 안 됩니다. 그렇지 않으면 팀은 같은 디자인을 검토한다고 생각하면서 서로 다른 자료를 놓고 논의하게 됩니다.
새로운 필요를 제기하는 방법도 정하세요. 편집자는 새 카드의 설명 글이 읽기 어렵다고 알리기 위해 토큰 표기법을 알 필요가 없습니다. 다만 주소, 콘텐츠 예시와 문제 설명을 누구에게 전달할지는 알아야 합니다. 담당자는 새 역할이 필요한지, 공통 값을 고쳐야 하는지, 개별 컴포넌트를 수정해야 하는지 판단할 수 있습니다. 그러면 시스템 사용자가 규칙을 바꿀 경로가 없어 임시방편을 만들지 않아도 됩니다.
새 값에는 짧은 이유가 있어야 합니다. “패널과 배경을 더 잘 구분해야 한다”는 평가의 근거가 됩니다. “이 시안에서는 더 좋아 보였다”는 대화의 출발점일 수 있지만 공통 규칙으로는 부족합니다. 새 역할을 어디에 쓸 수 있는지도 기록해 모든 모호한 문제의 해결책이 되지 않게 하세요.
토큰 수로 완성도를 판단하지 마세요. 작은 사이트라면 아무도 적용할 줄 모르는 방대한 이름 목록보다 잘 사용하는 결정 스무 개가 더 나은 출발일 수 있습니다. 프로젝트의 모든 과거를 다시 살피지 않고도 다음 변경을 할 수 있어야 합니다.
검수할 때 디자이너와 개발자에게 같은 요소와 그 역할을 짚어 달라고 요청하세요. 그런 다음 변경 하나를 골라 영향을 따라가 봅니다. 두 사람 모두 무엇이 바뀌었는지, 어디를 확인해야 하는지, 다른 곳은 왜 범위 밖인지 설명할 수 있다면 세트가 제 역할을 하기 시작한 것입니다. 깔끔한 값 목록을 보여 주는 것보다 구체적인 시험입니다.
결정의 책임자도 정하세요. 토큰이 스스로 질서를 유지하지는 않습니다. 요소의 역할을 이해하고 변경 이유를 기록하는 팀이 질서를 유지하도록 돕습니다. 그러면 빨간색이 조금 과하다는 의견도 모든 화면을 헤매는 일 대신 짧고 검증 가능한 수정이 될 수 있습니다.








