Refactoring UI
시각적 디자인은 재능이 아닙니다. 그것은 한 번만 결정하는 소수의 시스템과 계층을 만드는 소수의 기술로 이루어집니다. 이 스킬이 바로 그 시스템과 그 기술입니다.
아마추어 같은 UI의 가장 큰 원인은 임시방편으로 값을 선택하는 것입니다. — 여기는 17px,
저기는 #3B82F6, 호버 상태는 lighten(5%). 항상 스케일에서 디자인하세요.
시스템 — 이것들을 사용하세요, 새로 유도하지 마세요
이 목록들에서 선택하세요. 목록에 없는 값을 절대 새로 만들지 마세요.
간격과 크기
기본 16px, 그것의 인수와 배수로 구성:
4 8 12 16 24 32 48 64 96 128 192 256 384 512 640 768
작은 쪽은 촘촘하고, 큰 쪽은 넓게 퍼집니다. 인접한 두 값은 약 25% 이상 차이가 나서는 안 됩니다 — 그래야 선택이 명확해집니다. 선형적인 "4의 배수" 스케일은 실패합니다: 120px와 124px 사이에서 결정하는 데 도움이 되지 않습니다.
마진, 패딩, 너비, 높이, 아이콘 크기, 테두리 너비 등 모든 공간적인 것에 사용하세요.
비활성 상태, 오버레이, 호버 틴트를 위해 소수의 불투명도 값(예: .05 .1 .2 .4 .6 .8)도 고정하세요.
매번 슬라이더로 눈대중하는 대신 말이죠. 다른 스케일과 같은 논리입니다: 한 번 결정하고, 모든 곳에 재사용하세요.
타입 스케일
12 14 16 18 20 24 30 36 48 60 72
비율(4:5, 2:3, 황금비)로 만든 모듈러 스케일이 아닙니다. 그런 것들은 브라우저마다 일관되지 않게 반올림되는 분수 픽셀 값을 생성하고 인터페이스 밀도에 비해 너무 듬성듬성합니다. — 직접 고른 값들이 느낌에 따라 선택되므로 승리합니다.
단위: px 또는 rem만 사용하세요. 절대 em을 사용하지 마세요. em은 현재 폰트 크기에 상대적이므로,
1.25em 부모 안의 .875em은 17.5px로 계산됩니다 — 스케일에 없는 값입니다. 스케일이 조용히 사라집니다.
폰트 두께
두 가지 무게면 충분합니다:
- 400 또는 500 — 본문 및 대부분의 UI 텍스트
- 600 또는 700 — 강조된 모든 것
UI에서 400 미만은 사용하지 마세요. 덜 강조하려면 더 밝은 색상이나 더 작은 크기를 사용하세요 — 절대 더 가벼운 무게를 사용하지 마세요.
색상
다섯 가지 견본 팔레트 생성기가 제공하는 것보다 훨씬 더 많은 색상이 필요합니다.
- 회색: 8–10 단계. UI의 거의 모든 것은 회색입니다 — 텍스트, 배경, 패널, 테두리, 폼 컨트롤. 서너 단계로는 항상 부족합니다. 매우 어두운 회색에서 시작하고, 진정한 검정은 피하세요 (진정한 검정은 부자연스러워 보입니다).
- 기본 색상: 5–10 단계, 하나 또는 두 개의 기본 색상.
- 강조 색상: 각각 5–10 단계 — 파괴적인 빨강, 경고 노랑, 긍정적인 초록, 그리고 제품이 구별해야 하는 다른 것들(차트 시리즈, 캘린더 이벤트, 태그). 복잡한 UI의 경우 10가지 색상 × 5–10 단계가 일반적입니다.
이름을 100(가장 밝음) → 900(가장 어두움)으로 지정하고, 기본은 500입니다.
이 순서로 스케일을 구축하세요: 먼저 500을 고르세요(기본/강조 색상의 경우 버튼 배경으로
작동하는 색조여야 합니다). 그런 다음 가장자리를 찾으세요 — 900은 보통 텍스트 색상이고,
100은 배경 틴트입니다; 경고 컴포넌트는 둘 다 사용하므로, 하나를 디자인하고 두 값을 읽어내세요.
그런 다음 700과 300을 이웃 간의 완벽한 타협점으로 채우고, 같은 방식으로
800 600 400 200을 채우세요.
색상을 16진수가 아닌 HSL로 작성하세요. hsl(220, 95%, 34%)와 hsl(220, 65%, 61%)는
시각적으로 관련되어 있지만, #03369E와 #507DD7는 그렇지 않습니다.
런타임에 lighten() / darken()으로 색조를 생성하지 마세요.
그렇게 하면 35개의 약간 다른 파란색이 생깁니다.
그림자 — 다섯 가지 높이
0 1px 3px hsla(0,0%,0%,.2) /* 거의 떠 있지 않음 — 버튼 */
0 4px 6px hsla(0,0%,0%,.2) /* 드롭다운 */
0 5px 15px hsla(0,0%,0%,.2)
0 10px 24px hsla(0,0%,0%,.2)
0 15px 35px hsla(0,0%,0%,.2) /* 모달 */
이것이 z축의 어디에 위치하는가? 를 물어서 선택하고, 어떤 그림자가 예뻐 보이는가? 로 선택하지 마세요.
사용자에게 더 가까울수록 = 더 많은 주의를 받습니다. :active에서 버튼의 그림자를 줄이면 눌린 느낌이 들고,
드래그 재정렬을 위해 선택되었을 때 목록 항목의 그림자를 키우면 반대 효과가 납니다 —
"이제 형제들 위에 있다"고 읽히며 드래그 어포던스 자체로도 작용합니다.
이 다섯 가지가 기본이며 모든 곳에서 괜찮습니다. references/techniques.md는 동일한 스케일의
정제된 두 부분 버전을 제공합니다 — 병렬이지만 동일하지 않은 값입니다(상단 단계가 더 무겁습니다).
디자인에서 그림자가 두드러질 때 사용하세요; 그렇지 않을 때는 이것들을 사용하세요.
하나의 프로젝트에서 둘을 혼합하지 마세요.
행간과 행 길이
행간은 폰트 크기에 반비례하고, 줄 너비에 비례합니다:
- 작은 텍스트 / 넓은 컬럼 →
1.5~2 - 큰 헤드라인 →
1이면 충분함
행 길이: 45–75자, 즉 max-width: 20em–35em. 이것은 주변 컨테이너가 더 넓더라도
단락에 적용됩니다 — 하나의 콘텐츠 영역에 혼합된 너비는 덜 정돈된 것이 아니라 더 정돈되어 보입니다.
(em은 여기서 올바릅니다 — 측정값이 감싸는 텍스트에 따라 조정되어야 합니다. "절대 em" 규칙은
타입 스케일에 한정되며, em이 중첩을 통해 누적됩니다. 이것을 "수정"하지 마세요.)
테두리 반경
하나를 고르고 일관되게 유지하세요. 작은 반경 = 중립적입니다. 큰 반경 = 장난기 있습니다. 없음 = 진지함/격식 있습니다. 하나의 인터페이스에서 각진 모서리와 둥근 모서리를 섞으면 항상 더 나빠 보입니다.
절차
1. 레이아웃이 아닌 기능부터 시작하세요. "앱"을 디자인하지 마세요 — 제품에 무엇이 있는지 알기 전에 상단 탐색과 사이드바 사이에서 결정할 수 없습니다. 실제 기능 하나(검색 양식, 메시지 작성기)를 디자인하고, 껍데기가 생겨나게 두세요.
2. 세부 사항은 나중에. 초기에는 서체, 그림자, 아이콘을 무시하세요. 먼저 그레이스케일로 작업하세요 — 계층이 색상보다는 간격, 대비, 크기에서 나오도록 강제합니다. 레이아웃이 작동하면 색상을 추가하세요.
3. 낮은 충실도에 과도하게 투자하지 마세요. 스케치, 와이어프레임, 목업은 일회용입니다 — 아무도 앱의 정적인 그림을 사용할 수 없습니다. 그것들은 아이디어를 탐구하기 위해 존재합니다; 결정이 내려지면 버리고 실제 제품을 만드세요.
4. 가장 작은 유용한 버전을 디자인하고, 그런 다음 빌드하세요. 짧은 디자인→코드 주기로 작업하세요. 아직 구축할 준비가 되지 않은 기능을 암시하지 마세요 — 아직 출시할 수 없는 첨부 파일 영역이 있는 댓글 상자는 전체 기능을 차단합니다. 있으면 좋은 것들은 나중에 디자인됩니다.
5. 제거를 통해 선택하세요. 스케일에서 값을 선택할 때: 올바르다고 생각되는 값을 추측한 다음, 양쪽 이웃과 비교하세요. 두 개는 분명히 틀릴 것입니다. 외부 옵션이 이기면, 그것을 새로운 중간값으로 삼아 비교를 다시 실행하세요.
6. 너무 많은 흰 공간으로 시작하고 제거하세요. 공간을 추가하여 나빠 보이지 않을 때까지 하는 것은 최소한을 제공합니다. 넉넉하게 시작하고 다듬는 것이 올바른 양을 제공합니다. 빽빽한 UI(대시보드)는 합법적입니다 — 하지만 기본값이 아니라 의도적인 결정으로서요.
7. 캔버스를 줄이세요. 1400px 아트보드에서 디자인된 작은 컴포넌트는 공간이 채워져야 하므로 넓게 퍼지는 경향이 있습니다. 약 400px에서 시작하여 먼저 모바일 레이아웃을 디자인하세요. 제약 조건이 실제로 존재하는 곳에서 말이죠 — 그런 다음 큰 화면으로 가져와서 진정으로 비좁다고 느껴지는 것만 완화하세요. 예상보다 변경 사항이 적을 것입니다.
계층 — 가장 많은 작업을 수행하는 기술
화면의 모든 것은 피라미드에 있습니다: 기본, 보조, 3차. 모든 것이 경쟁하면 UI는 소음으로 읽힙니다. 이것이 디자인을 "디자인된" 것처럼 보이게 만드는 것입니다 — 스타일링이 아니라요.
크기가 전부는 아닙니다. 폰트 크기에만 의존하면 기본 콘텐츠가 너무 커지고 보조 콘텐츠가 너무 작아집니다. 대신 무게 와 색상 을 사용하여 강조를 전달하고 크기는 합리적으로 유지하세요.
최대 세 가지 텍스트 색상:
- 어두운 색 — 기본 콘텐츠
- 회색 — 보조 콘텐츠
- 더 밝은 회색 — 3차 콘텐츠(각주, 저작권)
세 가지 모두 실제 본문 크기의 텍스트를 전달하므로 모두 4.5:1 대비가 필요합니다. "더 밝은 회색"은 여전히 기준을 충족하는 가장 밝은 색조를 의미합니다 — 9단계 램프의 중간쯤, 창백한 쪽이 아닙니다. 창백한 색조는 비활성 상태와 큰 텍스트에만 사용됩니다.
덜 강조함으로써 강조하세요. 중요한 요소가 눈에 띄지 않고 추가할 것이 남지 않았을 때, 대신 경쟁하는 요소를 부드럽게 하세요. 비활성 탐색 항목을 흐리게 하고, 사이드바의 배경색을 낮춰 기본 콘텐츠가 앞으로 나오게 하세요.
액션: 의미론이 아닌 계층별로 스타일을 지정하세요.
- 기본 → 단색, 높은 대비. 보통 페이지당 정확히 하나.
- 보조 → 외곽선 또는 낮은 대비 배경.
- 3차 → 링크처럼 스타일 지정.
파괴적 ≠ 크고 빨간 버튼. "삭제"가 페이지의 기본 동작이 아니라면 3차 처리를 하세요 — 그런 다음 확인 대화상자 내부에서는 크고 빨간 기본 버튼으로 만드세요, 거기서는 진정으로 기본 동작이기 때문입니다.
레이블은 최후의 수단입니다. 레이블: 값은 모든 데이터에 동일한 가중치를 부여합니다.
대부분의 데이터는 형식($19.99, 이메일 주소) 또는 컨텍스트로 스스로를 식별합니다.
레이블이 진정으로 필요한 경우, 값을 접으세요("재고: 12" 대신 "12개 남음"),
또는 시각적으로 보조 콘텐츠로 추가하세요. 예외: 사용자가 레이블을 위해 스캔하는
사양 시트 스타일 페이지에서는 대신 레이블을 강조하세요.
무게와 대비의 균형을 맞추세요. 단색 아이콘은 시각적으로 무거워서 옆의 텍스트를 압도할 것입니다 — 색상을 부드럽게 하여 보상하세요. 반대로도 작동합니다: 부드러운 색상에서 1px 테두리가 너무 미묘하지만 어둡게 하면 너무 강해질 때, 부드러운 색상을 유지하고 2px로 가세요. 낮은 대비를 고치려면 무게를 추가하고, 과도한 무게를 고치려면 대비를 줄이세요.
시각적 계층 ≠ 문서 계층. 의미론적 마크업과 시각적 무게는 별개의 결정입니다.
섹션 제목은 보통 레이블이지 헤드라인이 아닙니다 — 16px의 h1도 괜찮으며, 때로는 콘텐츠가
스스로 말하기 때문에 제목이 완전히 시각적으로 숨겨져야 합니다.
하드 규칙
이것들에서 벗어나면 특정하고 인식 가능한 실패가 발생합니다.
- 색상 배경 위에 회색 텍스트를 절대 사용하지 마세요. 흰색 위의 회색은 대비를 줄이기 때문에 작동합니다; 색상 위의 회색은 그냥 더러워 보입니다. 불투명도가 줄어든 흰색은 빛바래고 비활성화된 것처럼 보이며, 글리프를 통해 패턴이 보이게 합니다. 배경의 색조를 사용하여 채도와 명도를 조정한 색상을 직접 고르세요.
- 타입 스케일에 절대
em을 사용하지 마세요.px또는rem. - 런타임에 색조를 절대 생성하지 마세요. 미리 정의하세요.
- 확장되면 안 되는 것에 절대 백분율 너비를 사용하지 마세요. 사이드바는 고정 너비를 받습니다;
기본 영역은 유연해집니다. 요소는
max-width를 가지며 화면이 실제로 더 작을 때만 줄어듭니다 — 로그인 카드는 큰 화면보다 중간 화면에서 더 넓어져서는 안 됩니다. - 중단점에 걸쳐 비례적으로 크기를 조정하지 마세요. 큰 요소는 작은 요소보다 더 빠르게 줄어들어야 합니다. 14px 모바일 본문에 있는 2.5em 헤드라인은 35px로 계산됩니다 — 너무 큽니다; 거기서는 20–24px이어야 합니다. 마찬가지로 버튼의 패딩은 버튼이 줄어들수록 비례적으로 더 좁아져야 하며, 폰트 크기와 함께 조정되지 않아야 합니다.
- 항상 그룹 주위의 공간이 그룹 내부의 공간보다 더 커야 합니다. 이것은 "어떤 레이블이 어떤 필드에 속하는지", 빽빽한 글머리 기호 목록, 그리고 잘못된 단락에 붙어 있는 것처럼 보이는 제목에 대한 해결책입니다. 모호한 간격은 단지 보기 흉한 것뿐만 아니라 기능적 버그입니다.
- 절대 색상을 유일한 신호로 사용하지 마세요. 아이콘, 모양 또는 텍스트 신호를 추가하세요. 차트의 경우 색조(한 색상의 밝음→어두움 음영)보다는 대비로 시리즈를 구별하세요 — 색맹 사용자는 밝기를 안정적으로 읽지만 색조는 그렇지 않습니다.
- 최소 대비: 일반 텍스트의 경우 4.5:1. 3:1 허용치는 큰 텍스트에만 적용되며, WCAG는
이를 24px 일반 또는 18.66px 굵게로 정의합니다 — 18px가 아닙니다. 텍스트가 진정으로 그렇게
크지 않다면 4.5:1로 가정하세요. 색상 위의 흰색이 실패하면 반전시키세요: 밝은 색조 위에
어두운 색상 텍스트(
references/systems.md참조). 별도로, 3:1은 텍스트가 아닌 것에도 적용됩니다 (WCAG 1.4.11): 테두리가 컨트롤을 식별하는 유일한 것이라면 — 입력 외곽선, 체크박스 가장자리 — 배경에 대해 3:1이 필요합니다. 단순히 콘텐츠를 나누는 가는 선은 그렇지 않습니다. 이것들은 하나가 아닌 두 개의 다른 토큰입니다. - 아이콘을 의도된 크기에서 멀리 절대 확장하지 마세요. 48px에서 16–24px 아이콘은 투박하고 디테일이 부족해 보입니다. 대신 색상 원 안에 넣으세요.
참고 자료
assets/tokens.css — 위의 모든 것에 대한 완전하고 대비가 확인된 시작 세트를 CSS 사용자 정의
속성으로 제공합니다: 간격, 타입, 두께, 테두리 너비, 고정 불투명도 스케일, 9단계 차가운 회색 램프,
9단계 기본 색상, 세 가지 강조 트리오, 다섯 가지 높이, 의미론적 역할 레이어 (--surface,
--text-primary, --action…) 및 해당 역할만 재정의하는 다크 모드 블록. 그것을 복사하고
이 글에서 스케일을 다시 유도하기보다 색조를 재조정하세요. 컴포넌트에서 원시 램프가 아닌 역할을
참조하세요 — 그것이 다크 모드를 작동하게 만드는 것입니다. 모든 텍스트/표면 쌍은 두 모드에서 ≥4.5:1로
확인되었고 모든 기능적 테두리는 ≥3:1입니다; 의도적인 임계값 미만 음영(비활성, 장식용 구분선,
큰 텍스트 전용 단계)은 기준에 의해 제외되며 인라인으로 주석 처리되었습니다.
작업에서 필요할 때 이것들을 로드하세요:
references/systems.md— 처음부터 팔레트 구축하기: 기본 색상 선택, 밝고 어두운 끝에서 채도 유지, 색조 회전, 따뜻함/차가움 회색, 그리고 못생긴 색상 없이 대비 비율을 맞추기 위한 두 가지 탈출구.references/diagnose.md— 증상 → 수정 표. 새로 구축하는 것이 아니라 기존 UI를 개선하는 작업일 때 먼저 로드하세요.references/techniques.md— 깊이와 빛 시뮬레이션, 두 부분 그림자, 기준선 정렬, 자간, 기본 컴포넌트 모양에서 벗어나기, 사용자 업로드 이미지 처리.
추가 사항 (추가 참고)
이 스킬은 AlessandroFare/fluxychat 저장소의 모든 참조 파일과 함께 사용하도록 설계되었습니다.
에이전트는 디자인 문제 진단 시 references/diagnose.md를, 첫 번째 팔레트 구축 시
references/systems.md를, 고급 시각적 기법이 필요할 때 references/techniques.md를 참조해야 합니다.
실제 프로젝트에서 가장 빠른 시작을 위해 assets/tokens.css를 복사하여 사용하는 것이 좋습니다.