UI 디자인: 인터페이스 구축을 위한 규칙
이 규칙들은 Michael Filipiuk 저 『UI Design Principles』(2021년판)에서 정리되었습니다. 이 파일은 모든 화면에 적용되는 규칙을 담고 있습니다. references/(이 파일과 같은 위치)에는 주제별로 하나씩 상세 파일이 있습니다. 작업과 관련된 파일만 읽으세요.
태그가 없는 규칙은 책에서 가져온 것입니다. **(WCAG)**는 책에 명시되지 않은 접근성 표준을 나타냅니다. **(convention)**은 격차를 메우기 위해 추가된 일반적인 업계 값을 나타냅니다. **(derived)**는 책의 고유 방법으로 계산된 값을 나타냅니다. 책의 1pt = CSS 1px = iOS 1pt = Android 1dp.
저장소의 디자인 시스템이 우선합니다.
저장소에 이미 토큰이나 테마(Tailwind 설정, CSS 변수, shadcn/MUI 테마, components/ui/ 라이브러리)가 있다면 그것을 사용하세요. 이 스킬은 정의되지 않은 부분만 채웁니다.
- 저장소 자체의 토큰 옆에 두 번째 토큰 세트를 절대 도입하지 마세요.
- 병렬 컴포넌트를 만드는 대신 기존 컴포넌트를 재사용하세요.
- 저장소 자체가 아래 규칙 중 하나를 위반하는 경우(예: 실패한 대비, 32px 버튼), 저장소의 값을 유지하고 충돌을 보고하세요. 조용히 재정의하지 마세요.
규칙 충돌 시 우선순위: 사용성 > 접근성 > 일관성 > 단순성 > 외관.
빠른 경로
- 개성 먼저: 브랜드와 대상에 따라 유쾌함, 중립 또는 진지함 (
references/personality-and-copy.md). 절대 자신의 취향으로 하지 마세요. - 화면보다 토큰 먼저: 저장소 또는
references/tokens.md에서 색상, 서체 배율 및 간격 배율을 가져오세요. 그 외의 것은 사용하지 마세요. - 그레이스케일 먼저: 계층, 레이아웃 및 간격을 먼저 올바르게 잡고, 그런 다음 역할이 있는 곳에만 색상을 추가하세요.
- 모든 상태를 가진 컴포넌트(기본, 호버, 누름, 포커스, 비활성화, 오류, 성공) 및 모든 화면 상태(빈 상태, 로딩 중, 오류, 404).
- 완료 보고 전: 구축한 내용에 대해
references/checklist.md를 확인하세요. 스크린샷을 찍을 수 있다면, 코드가 아닌 스크린샷을 확인하세요.
비타협적 규칙
- 간격은 배율에서 나옵니다. 모바일에서는 4pt 배율, 웹에서는 8pt 배율을 사용하세요. 5, 13 또는 22px 값은 사용하지 마세요.
- 본문 텍스트는 16–17px입니다. 어떤 텍스트도 절대 10px 미만으로 내려가지 말고, 12px 이상을 선호하세요. 작은 텍스트에 Light 체중을 사용하지 마세요.
- 하나의 서체, 기본값으로 산세리프체를 사용하세요. 약 5가지 크기를 사용하세요.
- 텍스트나 그림자에
#000000을 절대 사용하지 마세요.#1F1F1F와 같은 어두운 회색조를 사용하세요. - 하나의 기본 색상, 눈에 띄어야 하는 곳에만 적용하세요. 모든 것이 눈에 띄면 아무것도 눈에 띄지 않습니다.
- 대비: 본문 텍스트는 4.5:1, 큰 텍스트 및 UI 부품은 3:1 (WCAG).
- 의미를 전달하기 위해 색상만 사용하지 마세요. 오류, 성공 메시지 및 링크에는 아이콘, 텍스트, 체중 또는 밑줄도 함께 제공하세요.
- 모든 탭 또는 클릭 대상은 최소 44×44입니다. 보이는 글리프가 더 작더라도 마찬가지입니다.
- 버튼 높이는 40–60px이며, 그룹당 하나의 기본 버튼이 있습니다. 버튼이 쌍으로 올 때 기본 버튼은 오른쪽에 있습니다. 레이블은 정확히 어떤 일이 발생하는지 말합니다.
- 입력 필드에는 항상 보이는 레이블이 있습니다. 플레이스홀더만으로는 레이블이 아닙니다. 인라인 유효성 검사가 있는 단일 열 양식을 사용하고, 사용자가 입력한 내용을 절대 지우지 마세요.
- 그림자는 부드럽고(큰 Y 오프셋, 큰 블러, 5–10% 불투명도), 대화형 또는 상승된 요소에만 사용하세요.
- 아이콘은 하나의 팩에서, 하나의 스타일로, 동일한 선 두께와 둥글기를 가져야 합니다. 보편적으로 알려지지 않은 아이콘에는 레이블이 있어야 합니다.
- 애니메이션은 피드백을 제공하고, 1000ms 미만 지속되며, 이즈 처리됩니다(절대 선형 안 됨).
- Lorem Ipsum을 사용하지 마세요. 실제로 짧고, 인간적인 카피를 작성하세요. 오류는 문제 해결 방법을 말합니다. 대화상자는 객체와 결과를 명명합니다.
- 동일한 것은 화면 전체에서 동일한 모양과 동작을 가집니다. 동작은 플랫폼 패턴을 따르세요.
읽어야 할 참조 파일
| 작업이 다루는 내용 | 읽을 파일 |
|---|---|
| 새 프로젝트 또는 테마, 값 선택 | tokens.md (간격, 서체 배율, 색상 역할, 반경, 그림자, 모션, 시작 CSS) |
| 페이지 또는 화면 레이아웃, 그리드, 간격, 계층 | layout.md |
| 텍스트 스타일, 제목, 단락 | typography.md |
| 팔레트, 다크 모드, 그림자, 그라데이션 | color-and-depth.md |
| 버튼 및 CTA | buttons.md |
| 폼, 입력 필드, 선택 상자, 체크박스, 유효성 검사 | forms.md |
| 카드, 항목 목록 | cards.md |
| 아이콘 | icons.md |
| 탭 바, 상단 내비게이션, 사이드바, 링크 | navigation.md |
| 사진, 일러스트레이션, 빈 상태 및 404 아트 | imagery.md |
| 브랜드 느낌, 버튼 레이블, 대화상자, 오류, 어조 | personality-and-copy.md |
| 전환, 호버, 로딩, 피드백 | motion.md |
| 대비, 대체 텍스트, 대상, 캡션 | accessibility.md |
| 재사용할 컴포넌트, 상태, 빈/404 화면, 디자인 시스템 | system-and-states.md |
| 완성된 화면 검토 | checklist.md |
모든 경로는 이 스킬의 references/ 폴더 아래에 있습니다.