Atlassian Design System

역할 기반 토큰으로 받쳐주는 차분한 협업 톤

서양디자인 시스템생산성엔터프라이즈차가운modern-minimal고딕compactsoftsubtle라이트다크공식한글 지원출시 2017개정 2023

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

Brand DNA

브랜드 DNA

브랜드명: Atlassian Design System (ADS)
한 줄 정체성: 팀의 협업을 차분하게 받쳐주는, 역할 기반 토큰의 엔터프라이즈 시스템
공식 디자인 철학: "Design with purpose — clear, confident, supportive"
시그니처 요소 1개: Atlassian Blue 500(#0052CC) + 의미 기반 토큰(elevation.surface, color.background.brand.bold) 구조

Tone & Mood

톤 & 무드

핵심 키워드 3개: 차분함, 협업적, 명료함
무드 설명: 흰 캔버스에 차분한 진청색이 한 점으로 작용한다. 컴포넌트 라인은 부드럽고, 글자는 작지만 충분한 line-height로 호흡을 준다.
비주얼 스타일: 모던 미니멀
밀도(Density): Compact — Jira/Confluence처럼 정보량 많은 화면에 맞춤
모서리 성향: Soft (3~6px)
평면성: Subtle — 1단계 그림자와 hover 색 변화로 위계

Color System

컬러 시스템 (CSS 변수)

:root {
  /* Primary - Atlassian Blue */
  --color-primary-50:  #DEEBFF;  /* B50 */
  --color-primary-100: #B3D4FF;  /* B75 */
  --color-primary-200: #4C9AFF;  /* B200 */
  --color-primary-300: #2684FF;  /* B300 */
  --color-primary-400: #0065FF;  /* B400 */
  --color-primary-500: #0052CC;  /* B500 — primary action */
  --color-primary-600: #0747A6;  /* B600 */
  --color-primary-700: #053A8E;
  --color-primary-800: #042B6E;
  --color-primary-900: #032148;

  /* Secondary - Purple */
  --color-secondary-500: #6554C0;

  /* Neutral - Atlassian neutral scale */
  --color-neutral-0:    #FFFFFF;
  --color-neutral-50:   #F4F5F7;  /* N20 */
  --color-neutral-100:  #EBECF0;  /* N30 */
  --color-neutral-200:  #DFE1E6;  /* N40 */
  --color-neutral-300:  #C1C7D0;  /* N60 */
  --color-neutral-500:  #7A869A;  /* N200 */
  --color-neutral-700:  #5E6C84;  /* N300 */
  --color-neutral-800:  #42526E;  /* N400 */
  --color-neutral-900:  #172B4D;  /* N800 — text primary */
  --color-neutral-1000: #091E42;  /* N900 */

  /* Semantic */
  --color-success-bg: #E3FCEF;
  --color-success-fg: #006644;
  --color-warning-bg: #FFFAE6;
  --color-warning-fg: #FF8B00;
  --color-error-bg:   #FFEBE6;
  --color-error-fg:   #DE350B;
  --color-info-bg:    #DEEBFF;
  --color-info-fg:    #0747A6;

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

  /* Text */
  --text-primary:    #172B4D;
  --text-secondary:  #42526E;
  --text-tertiary:   #6B778C;
  --text-on-primary: #FFFFFF;
  --text-disabled:   #A5ADBA;

  /* Border */
  --border-default: #DFE1E6;
  --border-subtle:  #EBECF0;
  --border-strong:  #C1C7D0;
  --border-focus:   #4C9AFF;
}

[data-theme="dark"] {
  --bg-base: #1D2125;
  --bg-subtle: #22272B;
  --bg-elevated: #282E33;
  --text-primary: #E6EDF3;
  --text-secondary: #B6C2CF;
}

Typography

타이포그래피

폰트 페어링:
- 영문: Charlie Display / Charlie Text (Atlassian 자체 폰트, 웹 폴백 -apple-system)
- 한글: Pretendard 또는 Noto Sans KR (OFL)
위계 (ADS heading scale):
- Display: 35px / 600 / 1.14 / -0.01em
- H1: 29px / 500 / 1.10 / -0.01em
- H2: 24px / 500 / 1.17 / -0.01em
- H3: 20px / 500 / 1.20 / -0.008em
- Body Large: 16px / 400 / 1.5 / 0
- Body: 14px / 400 / 1.43 / 0
- Body Small: 12px / 400 / 1.33 / 0
- Caption: 11px / 600 / 1.27 / 0.04em (uppercase)

Spacing

스페이싱

Base unit: 4px (gridSize)
토큰: ``css --space-xs: 4px; /* space.050 */ --space-sm: 8px; /* space.100 */ --space-md: 16px; /* space.200 */ --space-lg: 24px; /* space.300 */ --space-xl: 32px; /* space.400 */ --space-2xl: 48px; /* space.600 */ --space-3xl: 64px; /* space.800 */ ``
Container: max-width 1024px (앱 콘텐츠), 좌우 패딩 24px

Border Radius

--radius-none: 0;
--radius-sm: 3px;     /* border.radius.050 */
--radius-md: 6px;     /* border.radius.100 — 기본 */
--radius-lg: 8px;
--radius-xl: 12px;
--radius-full: 9999px;

Shadow / Elevation

--shadow-none: none;
--shadow-sm: 0 1px 1px rgba(9,30,66,0.25), 0 0 1px rgba(9,30,66,0.31);   /* card resting */
--shadow-md: 0 4px 8px -2px rgba(9,30,66,0.25), 0 0 1px rgba(9,30,66,0.31); /* dropdown */
--shadow-lg: 0 8px 12px rgba(9,30,66,0.15), 0 0 1px rgba(9,30,66,0.31);    /* modal */
--shadow-xl: 0 12px 24px -6px rgba(9,30,66,0.25);                          /* dialog */

Iconography

스타일: Outline (Atlassian Iconography는 단일 outline weight)
Stroke 굵기: 2px (24px 사이즈 기준)
모서리 처리: Round (subtle round join)
추천 라이브러리: @atlaskit/icon (Atlassian 라이선스) / Lucide

Component Guide

컴포넌트 가이드

Button

.btn {
  font: 500 14px/1.43 "Charlie Text", -apple-system, "Pretendard", sans-serif;
  border-radius: var(--radius-sm);
  padding: 0 12px;
  height: 32px;
  display: inline-flex; align-items: center; gap: 6px;
  transition: background 100ms ease;
  border: 0;
}
.btn-primary { background: var(--color-primary-500); color: #fff; }
.btn-primary:hover { background: var(--color-primary-600); }
.btn-primary:active { background: var(--color-primary-700); }
.btn-primary:disabled { background: var(--color-neutral-100); color: var(--text-disabled); }

.btn-secondary { background: var(--bg-subtle); color: var(--text-primary); }
.btn-secondary:hover { background: var(--color-neutral-100); }
.btn-ghost { background: transparent; color: var(--text-primary); }
.btn-ghost:hover { background: var(--bg-subtle); }
.btn-danger { background: var(--color-error-fg); color: #fff; }

Input

.input {
  background: var(--bg-subtle);
  border: 2px solid transparent;
  border-radius: var(--radius-sm);
  padding: 6px 8px;
  height: 36px;
  font-size: 14px;
}
.input:hover { background: var(--color-neutral-100); }
.input:focus {
  outline: none;
  background: var(--bg-base);
  border-color: var(--border-focus);
}
.input[aria-invalid="true"] { border-color: var(--color-error-fg); }

Card

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

Badge / Lozenge

.lozenge { padding: 2px 6px; border-radius: var(--radius-sm); font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.04em; }
.lozenge-solid   { background: var(--color-primary-500); color: #fff; }
.lozenge-subtle  { background: var(--color-primary-50); color: var(--color-primary-600); }
.lozenge-outline { border: 1px solid var(--border-default); color: var(--text-secondary); }

Navigation (Side Nav)

.sidenav { width: 240px; background: var(--bg-subtle); padding: 16px 8px; height: 100vh; }
.sidenav a { display: flex; align-items: center; gap: 8px; padding: 8px 12px; border-radius: var(--radius-sm); color: var(--text-primary); font-size: 14px; font-weight: 500; }
.sidenav a:hover { background: var(--color-neutral-100); }
.sidenav a.active { background: var(--color-primary-50); color: var(--color-primary-600); }

Motion

--duration-fast: 100ms;
--duration-base: 200ms;
--duration-slow: 350ms;
--ease-out: cubic-bezier(0.15, 1, 0.3, 1);
--ease-in-out: cubic-bezier(0.2, 0, 0, 1);

Anti-patterns

1. raw hex 값 직접 사용 금지 — token (color.text, color.background.accent.blue.bolder)을 통해서만 2. lozenge에 4단계 이상 색 동시 사용 금지 — 상태 신호 혼란 3. text.subtle로 본문 텍스트 사용 금지 — 명도 대비 부족 4. 헤더에 large display 폰트 사용 금지 — Charlie Display는 hero에만 5. modal 위 modal (중첩 dialog) 금지 — 사용자 경로 추적 불가

Atlassian Design System

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

출처