/design-systems/github/DESIGN-ko.md

GitHub에서 영감을 받은 디자인 시스템

Category: 개발자 도구 코드 중심 플랫폼. 기능적 밀도, 청백색 정밀함, Primer 기반.

1. 비주얼 테마 & 분위기

GitHub의 화면은 장식되지 않고 설계되어 있습니다. 모든 픽셀이 하나의 태도를 선언합니다: 이것은 diff, 빌드, pull request를 중시하는 사람들을 위한 도구라고. 페이지 배경은 깔끔한 #ffffff(라이트) 또는 #0d1117(다크)이며, 콘텐츠는 여백 대신 얇은 테두리로 구분된 촘촘한 직사각형 패널 위에 배치됩니다. 정보 밀도 자체가 브랜드입니다 — 목록 행, 코드 줄, 저장소 헤더, 알림 카드가 모두 촘촘하게 배치되어 있어 파워 유저가 스크롤 없이 수백 개의 항목을 스캔할 수 있습니다.

시그니처 강조색은 링크와 주요 액션을 위한 Primer 블루(#0969da)와 병합 상태, 성공, 그리고 병합 버튼 자체를 위한 GitHub 그린(#1a7f37)입니다. 두 색상 모두 소비자 제품의 블루·그린보다 약간 차분하게 느껴집니다 — 촘촘한 회색 텍스트 위에서 읽힐 만큼 충분히 채도가 있으면서도, 한 화면에 여러 개가 나타날 때 배경으로 사라질 만큼 절제되어 있습니다.

타이포그래피는 전 제품에 걸쳐 system-ui 스택을 사용해 모든 OS에서 텍스트가 선명하게 렌더링되며, 코드에는 SFMono / Menlo / Consolas를 함께 사용합니다. 편집용 디스플레이 폰트는 없습니다; GitHub의 목소리는 당신이 이미 사용 중인 시스템의 목소리입니다.

주요 특징:

• 진정한 흰 캔버스(#ffffff) 또는 깊은 네이비-블랙(#0d1117) — 따뜻함도 색조도 없음
• 얇은 회색 테두리(#d0d7de)로 모든 패인과 패널을 정의
• Primer 블루(#0969da) — 링크/주요 액션; GitHub 그린(#1a7f37) — 성공/병합
• 산문에는 system-ui; 코드에는 SFMono — 사용자 정의 서체 없음
• 최소 패딩의 촘촘한 목록 행; 여백은 희소
• 16px / 24px의 Octicon 아이콘 — 단선, 기하학적, 일관적
• 강한 색상 의미를 가진 알약형 상태 배지

2. 색상 팔레트 & 역할

주요 색상

• Canvas Default (#ffffff): 기본 페이지 배경, 라이트 테마.
• Canvas Subtle (#f6f8fa): 보조 서페이스, 사이드바, 입력 배경, 헤더 스트립.
• Canvas Inset (#eaeef2): 코드 블록 배경, 깊은 인셋 서페이스.
• Fg Default (#1f2328): 기본 텍스트, 헤드라인, 잉크.
• Fg Muted (#656d76): 보조 텍스트, 캡션, 파일 경로.

브랜드 강조색

• Primer Blue (#0969da): 링크, 주요 CTA, 포커스 링 기반 — 범용 인터랙티브 색상.
• Primer Blue Hover (#0550ae): 주요 블루의 호버/눌림 상태.
• Accent Subtle (#ddf4ff): 콜아웃, 정보 배너를 위한 소프트 블루 서페이스.

의미론적 색상

• Success / Merge Green (#1a7f37): 병합된 PR, 성공 배지, 병합 버튼.
• Success Subtle (#dafbe1): 성공 서페이스 틴트.
• Open Green (#1a7f37): "열린" 이슈/PR 상태.
• Closed / Danger Red (#cf222e): 닫힌 PR, 파괴적 액션, 유효성 검사 오류.
• Danger Subtle (#ffebe9): 오류 배너 서페이스.
• Attention / Warning Yellow (#9a6700): 황색 서페이스 위의 경고 텍스트.
• Attention Subtle (#fff8c5): 경고 배너 서페이스.
• Done Purple (#8250df): 병합 후 보관됨, "완료" 상태, 프리미엄 배지.
• Sponsor Pink (#bf3989): 스폰서 하트, GitHub 스폰서 브랜드.

테두리 & 구분선

• Border Default (#d0d7de): 표준 얇은 테두리, 패널 외곽선.
• Border Muted (#d8dee4): 패널 내부 구분선.
• Border Subtle (#eaeef2): 희미한 테이블 행 구분선.

다크 테마

• Dark Canvas (#0d1117): 다크 페이지 배경.
• Dark Surface (#161b22): 사이드바, 헤더, 보조 서페이스.
• Dark Border (#30363d): 표준 다크 모드 테두리.
• Dark Fg (#e6edf3): 다크 배경 위의 기본 텍스트.

3. 타이포그래피 규칙

폰트 패밀리

• 본문 / UI: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif
• 코드 / 모노: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace
• 이모지: "Apple Color Emoji", "Segoe UI Emoji"

계층 구조

역할	폰트	크기	굵기	행 높이	자간	비고
Display	system-ui	32px (2rem)	600	1.25	-0.01em	저장소 헤더, 마케팅 히어로
H1	system-ui	24px (1.5rem)	600	1.25	normal	페이지 제목
H2	system-ui	20px (1.25rem)	600	1.25	normal	섹션 제목
H3	system-ui	16px (1rem)	600	1.25	normal	소섹션, 패널 헤더
Body	system-ui	14px (0.875rem)	400	1.5	normal	기본 텍스트 크기 — 16px가 아님
Body Small	system-ui	12px (0.75rem)	400	1.4	normal	캡션, 파일 메타데이터
Code	SFMono	12px (0.75rem)	400	1.45	normal	코드 블록, diff
Code Inline	SFMono	0.85em	400	inherit	normal	인라인 code 스팬

원칙

• 14px 본문, 16px 아님: GitHub의 산문 밀도는 그 정체성입니다. 하나의 뷰포트에 더 많은 행을 담기 위해 14px로 읽힙니다.
• 굵기 이진법: 기본적으로 모든 것은 400; 헤드라인과 강조에는 600. 500도 700도 없음.
• 시스템 폰트 항상: 크롬을 위해 웹폰트를 로드하지 않음 — 느린 연결에서도 텍스트가 즉시 렌더링되어야 함.

4. 컴포넌트 스타일링

버튼

Primary (그린)

• Background: #1f883d
• Text: #ffffff
• Border: 1px solid rgba(31, 35, 40, 0.15)
• Padding: 5px 16px
• Radius: 6px
• Shadow: 0 1px 0 rgba(31,35,40,0.1)
• Hover: background #1a7f37
• 사용: "저장소 만들기", "Pull request 병합"

Default

• Background: #f6f8fa
• Text: #1f2328
• Border: 1px solid #d0d7de
• Padding: 5px 16px
• Radius: 6px
• Hover: background #f3f4f6, border #d0d7de

Outline (블루 링크 스타일)

• Background: #ffffff
• Text: #0969da
• Border: 1px solid #d0d7de
• Hover: background #0969da, text #ffffff

Danger

• Background: #ffffff
• Text: #cf222e
• Border: 1px solid #d0d7de
• Hover: background #a40e26, text #ffffff, border #a40e26

카드 / 박스

• Background: #ffffff
• Border: 1px solid #d0d7de
• Radius: 6px
• Padding: 16px (헤더) + 16px (본문)
• 헤더에는 하단 테두리가 있는 #f6f8fa 스트립이 있음.

입력 필드

• Background: #ffffff
• Border: 1px solid #d0d7de
• Radius: 6px
• Padding: 5px 12px
• Focus: border #0969da, ring 0 0 0 3px rgba(9,105,218,0.3)

상태 알약 (이슈 / PR)

• Open: background #1a7f37, 흰 텍스트, padding 4px 10px, radius 9999px.
• Closed: background #cf222e, 흰 텍스트.
• Merged: background #8250df, 흰 텍스트.
• Draft: background #6e7781, 흰 텍스트.

레이블 (이슈/PR의 태그)

• Padding: 0 7px
• Radius: 9999px
• Font: 12px / 500
• 배경과 텍스트는 프로그래밍 방식으로 결정됨 (레이블 색상 → 대비를 위해 텍스트 색상 계산).

5. 간격 & 레이아웃

• 기본 단위: 4px. 간격 스케일: 4, 8, 12, 16, 24, 32, 40, 48.
• 페이지 최대 너비: 1280px (Container-xl).
• 사이드바: 데스크탑에서 296px, 1012px 이하에서 접힘.
• 행 패딩: 수평 16px, 수직 12px (목록은 의도적으로 촘촘하게 설계).

6. 모션

• 지속 시간: 호버에 80ms; 메뉴/팝오버 열기에 200ms.
• 이징: 열기에 ease-out, 닫기에 ease-in.
• 피해야 할 것: 페이지 로드 애니메이션, 패럴랙스, 지속적인 마이크로 인터랙션. 요소는 나타나는 것이지, 퍼포먼스를 하지 않습니다.

7. 사용 가이드라인

• 촘촘한 목록, 테두리가 있는 박스, 시스템 타이포그래피를 함께 유지하십시오; 고립된 그린 버튼만으로는 GitHub 같은 제품 표면을 만들기에 충분하지 않습니다.
• 저장소 구축 액션에는 그린, 링크와 포커스에는 블루, 이슈·PR·워크플로 상태에만 레드/퍼플/그레이를 사용하십시오.
• 장식적인 그림자나 대형 마케팅 스타일 카드보다는 조용한 크롬, 명시적인 테두리, 컴팩트한 간격을 선호하십시오.