Ant Design

12색 팔레트 generator와 표/폼 중심의 백오피스 표준

아시아디자인 시스템엔터프라이즈차가운modern-minimal고딕compactsoftsubtle라이트다크공식한글 지원출시 2015개정 2022

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

Brand DNA

브랜드 DNA

브랜드명: Ant Design (Ant Group)
한 줄 정체성: 엔터프라이즈 백오피스를 구축하기 위한, 표 형식 인터페이스에 최적화된 React 디자인 시스템
공식 디자인 철학: "Natural — Certain — Meaningful — Growing" (자연스러움, 확실성, 의미, 성장)
시그니처 요소 1개: Ant Daybreak Blue(#1677FF) + 12색 팔레트 generator + 정밀한 표/폼 컴포넌트

Tone & Mood

톤 & 무드

핵심 키워드 3개: 명료, 효율, 풍부
무드 설명: 깨끗한 흰 캔버스, 정확한 표 라인, 적당한 그림자. 데이터·폼·표가 90% 차지하는 어드민 화면을 가장 잘 다룬다.
비주얼 스타일: 모던 미니멀 (정보 위계 우선)
밀도(Density): Compact — 테이블/폼 중심
모서리 성향: Soft (6px 기본, v5에서 8px 카드)
평면성: Subtle — 그림자 1~2단계 + 라인

Color System

컬러 시스템 (CSS 변수)

:root {
  /* Primary - Daybreak Blue (Ant 12-step) */
  --color-primary-50:  #E6F4FF;  /* blue-1 */
  --color-primary-100: #BAE0FF;  /* blue-2 */
  --color-primary-200: #91CAFF;  /* blue-3 */
  --color-primary-300: #69B1FF;  /* blue-4 */
  --color-primary-400: #4096FF;  /* blue-5 */
  --color-primary-500: #1677FF;  /* blue-6 — primary v5 */
  --color-primary-600: #0958D9;  /* blue-7 — hover */
  --color-primary-700: #003EB3;  /* blue-8 */
  --color-primary-800: #002C8C;  /* blue-9 */
  --color-primary-900: #001D66;  /* blue-10 */

  /* Secondary - Volcano (CTA secondary) */
  --color-secondary-500: #FA541C;

  /* Neutral - Ant gray */
  --color-neutral-0:    #FFFFFF;
  --color-neutral-50:   #FAFAFA;  /* gray-1 */
  --color-neutral-100:  #F5F5F5;  /* gray-2 */
  --color-neutral-200:  #F0F0F0;  /* gray-3 — split-line */
  --color-neutral-300:  #D9D9D9;  /* gray-5 — border */
  --color-neutral-500:  #BFBFBF;  /* gray-6 */
  --color-neutral-700:  #8C8C8C;  /* gray-7 — text disabled */
  --color-neutral-800:  #595959;  /* gray-8 — text secondary */
  --color-neutral-900:  #262626;  /* gray-10 — text primary */
  --color-neutral-1000: #000000;  /* gray-13 */

  /* Semantic (Ant default) */
  --color-success-bg: #F6FFED;
  --color-success-fg: #52C41A;
  --color-warning-bg: #FFFBE6;
  --color-warning-fg: #FAAD14;
  --color-error-bg:   #FFF1F0;
  --color-error-fg:   #FF4D4F;
  --color-info-bg:    #E6F4FF;
  --color-info-fg:    #1677FF;

  /* Surface */
  --bg-base:     #FFFFFF;
  --bg-subtle:   #FAFAFA;
  --bg-elevated: #FFFFFF;
  --bg-overlay:  #FFFFFF;

  /* Text */
  --text-primary:    rgba(0,0,0,0.88);   /* v5 colorTextBase */
  --text-secondary:  rgba(0,0,0,0.65);
  --text-tertiary:   rgba(0,0,0,0.45);
  --text-on-primary: #FFFFFF;
  --text-disabled:   rgba(0,0,0,0.25);

  /* Border */
  --border-default: #D9D9D9;
  --border-subtle:  #F0F0F0;
  --border-strong:  #BFBFBF;
  --border-focus:   #1677FF;
}

[data-theme="dark"] {
  --bg-base: #141414;
  --bg-subtle: #1F1F1F;
  --bg-elevated: #262626;
  --text-primary: rgba(255,255,255,0.88);
  --text-secondary: rgba(255,255,255,0.65);
  --border-default: #424242;
  --color-primary-500: #1668DC;
}

Typography

타이포그래피

폰트 페어링:
- 영문: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto (system stack)
- 한글: "PingFang SC" 폴백 → "Apple SD Gothic Neo" / "Malgun Gothic"
위계 (Ant heading scale):
- Display: 38px / 600 / 1.23 / -0.02em
- H1: 30px / 600 / 1.27 / 0
- H2: 24px / 600 / 1.33 / 0
- H3: 20px / 600 / 1.4 / 0
- Body Large: 16px / 400 / 1.5 / 0
- Body: 14px / 400 / 1.5715 / 0
- Body Small: 12px / 400 / 1.66 / 0
- Caption: 12px / 400 / 1.66 / 0

Spacing

스페이싱

Base unit: 4px (Ant size)
토큰: ``css --space-xs: 4px; /* sizeXS */ --space-sm: 8px; /* sizeSM */ --space-md: 16px; /* size */ --space-lg: 24px; /* sizeLG */ --space-xl: 32px; /* sizeXL */ --space-2xl: 48px; --space-3xl: 64px; ``
Container: max-width 1200px (24열 grid), 좌우 패딩 16px (mobile) / 24px (desktop)

Border Radius

--radius-none: 0;
--radius-sm: 2px;
--radius-md: 6px;     /* v5 borderRadius 기본 */
--radius-lg: 8px;
--radius-xl: 12px;
--radius-full: 9999px;

Shadow / Elevation

--shadow-none: none;
--shadow-sm: 0 1px 2px 0 rgba(0,0,0,0.03), 0 1px 6px -1px rgba(0,0,0,0.02), 0 2px 4px 0 rgba(0,0,0,0.02);
--shadow-md: 0 6px 16px 0 rgba(0,0,0,0.08), 0 3px 6px -4px rgba(0,0,0,0.12), 0 9px 28px 8px rgba(0,0,0,0.05);
--shadow-lg: 0 6px 20px rgba(0,0,0,0.10);
--shadow-xl: 0 12px 32px rgba(0,0,0,0.16);

Iconography

스타일: Outline / Filled / Two-tone (Ant Design Icons는 동일 글리프 3종 weight)
Stroke 굵기: 1.5~2px (outline)
모서리 처리: Round
추천 라이브러리: @ant-design/icons (MIT, 800+) / Lucide

Component Guide

컴포넌트 가이드

Button (Ant: primary / default / dashed / text / link × default/hover/active/disabled)

.btn {
  font: 400 14px/1.5715 -apple-system, "Segoe UI", "PingFang SC", "Apple SD Gothic Neo", sans-serif;
  border-radius: var(--radius-md);
  padding: 4px 15px;
  height: 32px;
  display: inline-flex; align-items: center; gap: 8px;
  border: 1px solid var(--border-default);
  background: var(--bg-base);
  color: var(--text-primary);
  transition: all 0.2s cubic-bezier(0.645, 0.045, 0.355, 1);
  box-shadow: 0 2px 0 rgba(0,0,0,0.02);
}
.btn:hover { color: var(--color-primary-500); border-color: var(--color-primary-500); }
.btn-primary { background: var(--color-primary-500); border-color: var(--color-primary-500); color: #fff; box-shadow: 0 2px 0 rgba(5,145,255,0.10); }
.btn-primary:hover { background: var(--color-primary-400); border-color: var(--color-primary-400); color: #fff; }
.btn-primary:active { background: var(--color-primary-700); border-color: var(--color-primary-700); }
.btn-primary:disabled { background: var(--color-neutral-100); border-color: var(--border-default); color: var(--text-disabled); box-shadow: none; }

.btn-secondary { /* default */ }
.btn-ghost { background: transparent; border-color: transparent; color: var(--color-primary-500); box-shadow: none; }
.btn-ghost:hover { background: var(--color-primary-50); color: var(--color-primary-400); }
.btn-danger { background: var(--color-error-fg); border-color: var(--color-error-fg); color: #fff; }

Input

.input {
  background: var(--bg-base);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  padding: 4px 11px;
  height: 32px;
  font-size: 14px;
  transition: all 0.2s;
}
.input:hover { border-color: var(--color-primary-400); }
.input:focus {
  outline: none;
  border-color: var(--color-primary-500);
  box-shadow: 0 0 0 2px rgba(5,145,255,0.10);
}
.input[aria-invalid="true"] { border-color: var(--color-error-fg); box-shadow: 0 0 0 2px rgba(255,77,79,0.10); }

Card

.card { background: var(--bg-base); border: 1px solid var(--border-subtle); border-radius: var(--radius-lg); }
.card-head { padding: 0 24px; min-height: 56px; border-bottom: 1px solid var(--border-subtle); display: flex; align-items: center; font-weight: 600; }
.card-body { padding: 24px; }
.card-elevated { box-shadow: var(--shadow-sm); border-color: transparent; }
.card-outlined { box-shadow: none; }

Badge / Tag

.tag { padding: 0 7px; height: 22px; border-radius: var(--radius-sm); font-size: 12px; line-height: 20px; border: 1px solid; display: inline-flex; align-items: center; gap: 4px; }
.tag-solid   { background: var(--color-primary-500); color: #fff; border-color: var(--color-primary-500); }
.tag-subtle  { background: var(--color-primary-50); color: var(--color-primary-600); border-color: var(--color-primary-100); }
.tag-outline { background: var(--bg-base); border-color: var(--border-default); color: var(--text-primary); }

Navigation (Layout Header + Sider)

.layout-header { height: 64px; background: #001529; color: #fff; display: flex; align-items: center; padding: 0 50px; }
.layout-header .menu { display: flex; gap: 0; margin-left: 32px; }
.layout-header .menu a { color: rgba(255,255,255,0.65); padding: 0 20px; height: 64px; line-height: 64px; }
.layout-header .menu a.active { color: #fff; border-bottom: 2px solid var(--color-primary-500); }

Motion

--duration-fast: 100ms;
--duration-base: 200ms;
--duration-slow: 300ms;
--ease-out: cubic-bezier(0.215, 0.61, 0.355, 1);
--ease-in-out: cubic-bezier(0.645, 0.045, 0.355, 1);

Anti-patterns

1. 한 화면에 4가지 이상 brand color (Ant 12색 중 다수) 동시 사용 금지 — 신호 혼란 2. table row 높이를 32px 미만으로 압축 금지 — 14px 폰트 가독성 한계 3. tooltip을 정보 전달의 유일한 수단으로 사용 금지 — 모바일/터치 차단 4. modal 안에 modal 중첩 금지 — drawer 또는 단계 분리 권장 5. Compact size를 marketing 페이지에 사용 금지 — 어드민 전용

Ant Design

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

출처