KRDS — Korea Republic Design System
KRDS — Korea Republic Design System
krds

KRDS's design system uses #256EF4 as its primary color and "Pretendard GOV" for typography, with 6px corner radius. KRDS는 대한민국 행정·공공기관 웹·앱이 공유하는 정부 표준 디자인 시스템입니다.

Primary
#256EF4
Typography
"Pretendard GOV"
Radius
6px
Design System
KRDS logo

KRDS

KRDS는 대한민국 행정·공공기관 웹·앱이 공유하는 정부 표준 디자인 시스템입니다. 화면은 마케팅 브랜드가 아니라 공공 서비스의 도구처럼 보이도록 설계되었습니다 — 순백 배경(#ffffff) 위에 거의 검정에 가까운 본문(#1E2124), 그리고 신뢰감을 주는 정부 블루(#256EF4)가 단 하나의 강조색으로 작동합니다. 강조색은 그래픽 장식이 아니라 행위(action), 즉 "신청", "확인", "다음 단계"가 있는 자리에만 나타납니다. 영역 분리는 그림자가 아니라 얇은 회색 보더(#58616A 1px / #B1B8BE 1px / #CDD1D5 1px)와 8px 라운드로 처리되어, 시각적 무게

01

Color Palette

Brand

Accent

Neutrals

Semantic

02

Typography

Type Scale

Rendered in system-ui to clearly show scale & weight.

display48px · 700 · 1.25
Design at scale
32px32px · 700 · 1.25
Section heading
heading-lg24px · 700 · 1.4
Subheading
body16px · 400 · 1.5
Body text. The quick brown fox jumps over the lazy dog. Designed for readable line-height in long-form content.
small13px · 400 · 1.5
Supporting text
caption12px · 400 · 1.5
Caption · timestamp · 2026
label10px · 500 · 1.5
BADGE / LABEL

Fonts

Primary
Pretendard GOV
Brand-only
Not in the OMD font registry. Likely a brand-proprietary typeface — check the brand's own design site for source/availability.
Not publicly distributed.
Primary
Apple System
Systemno install needed
macOS/iOS default — uses SF Pro automatically.
Not publicly distributed.
Primary
Apple System (Blink)
Systemno install needed
Chrome alias for Apple system font on macOS.
Not publicly distributed.
Primary
Apple SD Gothic Neo
Systemno install needed
Apple system font for Korean.
Not publicly distributed.
Primary
Noto Sans KR
Open · OFL
Install via Google Fonts
03

Spacing & Shape

Spacing

PurposeValuePreview
Densitycompact
Base unit4px
Section gap24px
Card padding12px
Element gap8px

Border Radius

ElementValuePreview
buttons6px
inputs6px
cards6px
dialogs6px
badges6px

Elevation

Shadow 1
04

Guidelines

Do and Don't guidelines parsed from DESIGN.md.

Do

  • 정부 블루(#256EF4)는 액션 자리에만 — Primary 버튼, 활성 링크, 활성 탭, focus ring, side-menu 활성 표시
  • 본문은 17px / 400 / line-height 1.5 — 노안·저시력 사용자를 우선
  • 모든 인터랙티브 요소에 가시성 높은 4px outline focus ring 적용 (--krds-box-shadow-outline)
  • 양식 검증은 명시적 에러 라벨 + aria-invalid + 에러 영역 자동 포커스 + 2px border #DE3412
  • "글자·화면 표시 설정"을 항상 헤더에 노출 — 사용자의 1차 컨트롤
  • 한글 본문에 letter-spacing 0을 유지 — 인위적 자간 압축 금지 (Display만 1px)
  • Pretendard GOV 또는 시스템 한글 폴백을 사용
  • 색상은 매직넘버에 맞춰 선택 — primary-50 위 gray-0이면 즉시 4.5:1+ 통과
  • 모든 컴포넌트는 일반 모드 / 선명한 화면 모드 두 토큰 레이어로 검증

Don't

  • Primary 50을 배경 / 일러스트 / 헤더 풀-블리드에 쓰지 말 것 — 색은 행위(action)다
  • 그림자로 깊이감을 만들지 말 것 — 보더와 라운드로 충분
  • 한 화면에 두 개 이상의 Primary 버튼을 같은 위계로 두지 말 것 — 첫 번째 행위가 명확해야 함
  • 마케팅 카피·과장 표현 금지 — "혁신적인", "최고의", "감동의" 같은 수식어 금지
  • 모션을 강조 수단으로 쓰지 말 것 — prefers-reduced-motion 사용자가 다수
  • 정보 부재 상태에 "데이터가 없습니다" 같은 무미한 표현 금지 — 다음 행동을 안내할 것
  • KWCAG 2.1 AA 미달 컬러 / 컴포넌트 사용 금지 (4.5:1 contrast 최소)
05

Components

Buttons

button-primary
Background#256ef4
Text#ffffff
Border1px solid #256ef4
Radius6px
Padding0 16px
Font17px / 400
Hover#0b50d0
Active#083891
Disabledbg #cdd1d5 fg #6d7882
Use: Core action 신청하기/확인 (1 per screen)
button-secondary
Background#ecf2fe
Text#0b50d0
Border1px solid #256ef4
Radius6px
Padding0 16px
Font17px / 400
Use: Secondary action 자세히 보기/이전 단계
button-tertiary
Backgroundtransparent
Text#1e2124
Border1px solid #58616a
Radius6px
Padding0 16px
Font17px / 400
Hover#f4f5f6
Use: Cancel/reset 취소/초기화/닫기
button-floating
Background#256ef4
Text#ffffff
Radius1000px
Shadowweak box-shadow
Use: Bottom-right floating action 맨 위로/챗봇

Inputs

input-text
Background#ffffff
Text#464c53
Border1px solid #58616a
Radius8px
Padding0 16px
Font19px / 400
Focus0 0 0 4px #256ef4 halo
Disabledbg #cdd1d5 fg #6d7882 border #b1b8be
stateserror border 2px solid #de3412
Use: Standard text input (large default)
select
Background#ffffff
Text#1e2124
Border1px solid #58616a
Radius6px
Padding0 48px 0 16px
Font19px / 400
Disabledbg #cdd1d5 border #b1b8be
stateserror border 2px solid #ab2b36
Use: Native select with chevron

Toggles

toggle-checkbox
Background#ffffff
Border1px solid #58616a
Radius4px
Activebg #256ef4 + white check icon
Use: Multi-select checkbox
toggle-switch
Background#b1b8be
Text#ffffff
Radius1000px
Active#256ef4 track, white thumb right
Disabledbg #cdd1d5
Use: On/off toggle switch

Cards

card
card
Background#ffffff
Border1px solid #b1b8be
Radius8px
Padding24px
Shadownone
Use: Standard content panel, border-defined
card-info
card-info
Background#ecf2fe
Text#1e2124
Radius8px
Padding16px 24px
Use: Info/help panel 안내·도움말
card-critical
card-critical
Background#de3412
Text#ffffff
Radius0px
Use: Full-bleed urgent notice banner top of page

Dialogs

dialog
Dialog content placeholder
dialog
Background#ffffff
Text#1e2124
Radius12px
Padding40px
Shadow0 0.2rem 0 0 rgba(0,0,0,0.1), 0 0.4rem 0.8rem 0 rgba(0,0,0,0.1)
Use: Modal dialog, backdrop fade 0->0.5 black, min-height 264px

Badges

badge
badge-primary
Background#256ef4
Text#ffffff
Border1px solid #256ef4
Radius4px
Padding0 8px
Font15px / 400
Use: Content classification, action emphasis
badge
badge-point
Background#d63d4a
Text#ffffff
Radius4px
Padding0 8px
Font15px / 400
Use: Emphasis/new/important (red point)
badge
badge-success
Background#228738
Text#ffffff
Radius4px
Padding0 8px
Font15px / 400
Use: Completed / success
badge
badge-danger
Background#de3412
Text#ffffff
Radius4px
Padding0 8px
Font15px / 400
Use: Error / rejected
badge
badge-warning
Background#ffb114
Text#1e2124
Radius4px
Padding0 8px
Font15px / 400
Use: Caution (black text on warning bg)
badge
badge-tag
Background#ffffff
Text#1e2124
Border1px solid #cdd1d5
Radius1000px
Padding8px 10px
Font15px / 400
Activebg #ecf2fe fg #0b50d0 border #256ef4
Use: Selectable filter chip with delete button

Tabs

TabTabTab
tab-horizontal
Backgroundtransparent
Text#464c53
Font17px / 400
Activefg #256ef4 700 + 2px bottom border #256ef4
Use: In-page section switch, keyboard L/R nav

Toasts

toast
toast
Background#1e2124
Text#ffffff
Radius8px
Padding16px
Use: Center/bottom card, 3s auto-dismiss

Related design systems