GitHub Primer

라이트·다크 2개 컬러 모드와 9개 테마의 코드 친화 시스템

서양디자인 시스템개발 도구중립modern-minimal고딕compactsoftflat라이트다크공식한글 지원출시 2017개정 2024

갤러리에서 열기 — 적용 예시 · 가이드 다운로드

Brand DNA

브랜드 DNA

브랜드명: GitHub Primer Design System
한 줄 정체성: 개발자가 코드 옆에서 매일 살아내는, 정밀한 다크/라이트 어드민 시스템
공식 디자인 철학: "Designed for GitHub — fast, accessible, native to the developer's workflow"
시그니처 요소 1개: 라이트·다크 2개 컬러 모드와 9개 테마 + base·functional·component 3계층의 정교한 토큰 구조

Tone & Mood

톤 & 무드

핵심 키워드 3개: 정밀, 기능적, 코드 친화적
무드 설명: 거의 grayscale에 GitHub 시그니처 그린/블루가 점처럼 박힌다. 데이터 밀도가 높고 모노스페이스 코드와 함께 살아도 어색하지 않다.
비주얼 스타일: 모던 미니멀 (정보 위계 우선)
밀도(Density): Compact — 이슈, 코드뷰, 액션 등 정보량이 많은 화면
모서리 성향: Soft (6px 기본)
평면성: Flat — 거의 그림자 없음, border와 배경 톤 차이로 위계

Color System

컬러 시스템 (CSS 변수)

:root {
  /* Primary - Primer Blue (accent) */
  --color-primary-50:  #DDF4FF;  /* blue-0 */
  --color-primary-100: #B6E3FF;  /* blue-1 */
  --color-primary-200: #80CCFF;  /* blue-2 */
  --color-primary-300: #54AEFF;  /* blue-3 */
  --color-primary-400: #218BFF;  /* blue-4 */
  --color-primary-500: #0969DA;  /* blue-5 — accent */
  --color-primary-600: #0550AE;  /* blue-6 */
  --color-primary-700: #033D8B;
  --color-primary-800: #0A3069;
  --color-primary-900: #002155;

  /* Secondary - GitHub Green */
  --color-secondary-500: #1A7F37;  /* success bold */

  /* Neutral - Primer scale */
  --color-neutral-0:    #FFFFFF;
  --color-neutral-50:   #F6F8FA;  /* canvas-subtle */
  --color-neutral-100:  #EAEEF2;  /* border default */
  --color-neutral-200:  #D0D7DE;  /* border muted */
  --color-neutral-300:  #AFB8C1;
  --color-neutral-500:  #6E7781;  /* fg muted */
  --color-neutral-700:  #424A53;
  --color-neutral-800:  #32383F;
  --color-neutral-900:  #24292F;  /* fg default */
  --color-neutral-1000: #1F2328;

  /* Semantic */
  --color-success-bg: #DAFBE1;
  --color-success-fg: #1A7F37;
  --color-warning-bg: #FFF8C5;
  --color-warning-fg: #9A6700;
  --color-error-bg:   #FFEBE9;
  --color-error-fg:   #CF222E;
  --color-info-bg:    #DDF4FF;
  --color-info-fg:    #0969DA;

  /* Surface */
  --bg-base:     #FFFFFF;        /* canvas-default */
  --bg-subtle:   #F6F8FA;        /* canvas-subtle */
  --bg-elevated: #FFFFFF;        /* overlay */
  --bg-overlay:  #FFFFFF;

  /* Text */
  --text-primary:    #1F2328;    /* fg-default */
  --text-secondary:  #656D76;    /* fg-muted */
  --text-tertiary:   #6E7781;
  --text-on-primary: #FFFFFF;
  --text-disabled:   #8C959F;

  /* Border */
  --border-default: #D0D7DE;     /* border-default */
  --border-subtle:  #EAEEF2;
  --border-strong:  #AFB8C1;
  --border-focus:   #0969DA;
}

[data-theme="dark"] {
  /* Dark default */
  --bg-base: #0D1117;
  --bg-subtle: #161B22;
  --bg-elevated: #21262D;
  --text-primary: #E6EDF3;
  --text-secondary: #7D8590;
  --border-default: #30363D;
  --color-primary-500: #2F81F7;
}

[data-theme="dark-dimmed"] {
  --bg-base: #22272E;
  --bg-subtle: #2D333B;
  --text-primary: #ADBAC7;
  --color-primary-500: #539BF5;
}

Typography

타이포그래피

폰트 페어링:
- 영문: -apple-system / "Segoe UI" / "Helvetica Neue" 시스템 스택. GitHub 마케팅은 Mona Sans (OFL) 사용
- 한글: -apple-system 폴백 → "Apple SD Gothic Neo" / "Malgun Gothic"
- 모노스페이스: ui-monospace, "SF Mono", "Menlo", Consolas
위계 (Primer text):
- Display: 40px / 600 / 1.2 / -0.02em
- H1: 32px / 600 / 1.25 / 0
- H2: 24px / 600 / 1.25 / 0
- H3: 20px / 600 / 1.25 / 0
- Body Large: 16px / 400 / 1.5 / 0
- Body: 14px / 400 / 1.43 / 0
- Body Small: 12px / 400 / 1.33 / 0
- Caption: 12px / 400 / 1.33 / 0

Spacing

스페이싱

Base unit: 4px
토큰: ``css --space-xs: 4px; --space-sm: 8px; --space-md: 16px; --space-lg: 24px; --space-xl: 32px; --space-2xl: 48px; --space-3xl: 64px; ``
Container: max-width 1280px (xl), 1012px (lg), 좌우 패딩 16px (mobile) / 24px (tablet+)

Border Radius

--radius-none: 0;
--radius-sm: 3px;
--radius-md: 6px;     /* 기본 — 버튼, 입력, 카드 */
--radius-lg: 8px;
--radius-xl: 12px;
--radius-full: 9999px;

Shadow / Elevation

--shadow-none: none;
--shadow-sm: 0 1px 0 rgba(31,35,40,0.04);                      /* button resting */
--shadow-md: 0 3px 6px rgba(140,149,159,0.15);                 /* dropdown */
--shadow-lg: 0 8px 24px rgba(140,149,159,0.20);                /* modal */
--shadow-xl: 0 12px 28px rgba(140,149,159,0.30);

Iconography

스타일: Outline (Octicons는 12/16/24px outline, 모든 사이즈에서 픽셀 정렬)
Stroke 굵기: 1px (단일 weight, 사이즈별로 별도 그려짐)
모서리 처리: Square + Round 혼합
추천 라이브러리: @primer/octicons (MIT, 250+)

Component Guide

컴포넌트 가이드

Button (Primer는 default/primary/danger/invisible 4종)

.btn {
  font: 500 14px/1.43 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
  border-radius: var(--radius-md);
  padding: 5px 16px;
  height: 32px;
  display: inline-flex; align-items: center; gap: 6px;
  border: 1px solid var(--border-default);
  background: var(--bg-elevated);
  color: var(--text-primary);
  box-shadow: var(--shadow-sm), inset 0 1px 0 rgba(255,255,255,0.25);
  transition: background 80ms cubic-bezier(0.65, 0, 0.35, 1), border-color 80ms;
}
.btn:hover { background: #F3F4F6; border-color: #BABFC4; }
.btn:active { background: #EBECF0; }
.btn:disabled { color: var(--text-disabled); background: var(--bg-subtle); }

.btn-primary { background: var(--color-success-fg); border-color: rgba(31,35,40,0.15); color: #fff; box-shadow: 0 1px 0 rgba(31,35,40,0.10), inset 0 1px 0 rgba(255,255,255,0.20); }
.btn-primary:hover { background: #1F883D; }
.btn-primary:active { background: #197935; }
.btn-secondary { /* default 위 동일 */ }
.btn-ghost { background: transparent; border-color: transparent; color: var(--color-primary-500); box-shadow: none; }
.btn-ghost:hover { background: var(--bg-subtle); }
.btn-danger { background: var(--bg-elevated); color: var(--color-error-fg); border-color: var(--border-default); }
.btn-danger:hover { background: var(--color-error-fg); color: #fff; border-color: var(--color-error-fg); }

Input

.input {
  background: var(--bg-base);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  padding: 5px 12px;
  height: 32px;
  font-size: 14px;
  box-shadow: inset 0 1px 0 rgba(225,228,232,0.20);
}
.input:focus {
  outline: none;
  border-color: var(--border-focus);
  box-shadow: 0 0 0 3px rgba(9,105,218,0.30);
}
.input[aria-invalid="true"] { border-color: var(--color-error-fg); box-shadow: 0 0 0 3px rgba(207,34,46,0.30); }

Card (Box)

.card { background: var(--bg-elevated); border: 1px solid var(--border-default); border-radius: var(--radius-md); padding: 16px; }
.card-elevated { box-shadow: var(--shadow-md); }
.card-outlined { box-shadow: none; }

Badge / Label

.label { padding: 0 7px; height: 20px; border-radius: var(--radius-full); font-size: 12px; font-weight: 500; line-height: 18px; display: inline-flex; align-items: center; }
.label-solid   { background: var(--color-primary-500); color: #fff; }
.label-subtle  { background: var(--color-primary-50); color: var(--color-primary-700); }
.label-outline { border: 1px solid var(--border-default); color: var(--text-primary); background: transparent; }

Navigation (Header)

.gh-header { height: 64px; background: #24292F; color: #fff; display: flex; align-items: center; padding: 0 16px; gap: 16px; }
.gh-header a { color: #fff; font-size: 14px; font-weight: 600; padding: 8px 12px; border-radius: var(--radius-md); }
.gh-header a:hover { background: rgba(255,255,255,0.10); }

Motion

--duration-fast: 80ms;
--duration-base: 200ms;
--duration-slow: 350ms;
--ease-out: cubic-bezier(0.65, 0, 0.35, 1);
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);

Anti-patterns

1. 본문에 라이트/다크 양쪽에서 같은 hex 사용 금지 — var(--text-primary) 토큰을 거쳐야 자동 적응 2. 라벨(Label)에 4단계 이상 색 동시 사용 금지 — 이슈 라벨 가독성 저하 3. 모노스페이스를 본문 단락에 사용 금지 — 코드 인라인에 한정 4. 그라데이션 배경 위에 코드 블록 배치 금지 — 가독성 파괴 5. focus ring (3px 외곽 box-shadow) 제거 금지 — 키보드 접근성 핵심

GitHub Primer

Brand DNA

브랜드 DNA

Tone & Mood

톤 & 무드

Color System

컬러 시스템 (CSS 변수)

Typography

타이포그래피

Spacing

스페이싱

Border Radius

Border Radius

Shadow / Elevation

Shadow / Elevation

Iconography

Iconography

Component Guide

컴포넌트 가이드

Motion

Motion

Anti-patterns

Anti-patterns

Sources

출처