본문으로 건너뛰기
zest/ui

테마 · 강조색

ZEST UI는 구조는 고정, 강조색만 바꾸는 시스템이에요. 무채색 바탕, 밀도, 상태 색(진행·완료·대기·반려·예정)은 그대로 두고, 브랜드 색 하나만 바꿔요. 기본은 ZEST 그린 #03C75A예요.

강조색 만들기

색을 고르면 5단계를 만들고, 그린 글씨 자리(700)가 흰 바탕과 연한 바탕 모두에서 4.5:1이 될 때까지 자동으로 어둡게 맞춰요.

50
#E9FDEC

100
#C8F6CF

500
#03C75A

600
#09B150

700
#018238

조직장링크 글자
  • 그린 글씨 단계 × 흰 바탕 4.94 : 1
  • 그린 글씨 단계 × 연한 바탕 4.64 : 1
  • 주 버튼 글자 2.25 : 1 — 4.5 미만은 브랜드 예외로 기록하세요
:root {
  --green-50: #E9FDEC;
  --green-100: #C8F6CF;
  --green-500: #03C75A;
  --green-600: #09B150;
  --green-700: #018238;
  --brand-fg: #FFFFFF;
  --focus-ring: 0 0 0 3px color-mix(in srgb, #03C75A 28%, transparent);
}

.dark,
[data-theme="dark"] {
  --green-50: #0C2E16;
  --green-100: #0E401D;
  --green-600: #01AA4C;
  --green-700: #3FE273;
  --focus-ring: 0 0 0 3px color-mix(in srgb, #03C75A 40%, transparent);
}

만든 CSS(라이트 :root + 다크 .dark 두 블록)를 tokens.css 다음에 붙여 넣으면 끝이에요. 다크 블록이 빠지면 다크 모드에서 ZEST 그린 값이 남아요.

코드로 만들기

import { generateAccent, accentCss } from '@zest-im/ui'

const accent = generateAccent('#FF5A00')
accent.contrast // { brandTextOnWhite, brandTextOnSoft, textOnBrand } — 그린 글씨 단계는 늘 4.5 이상
const css = accentCss(accent) // ':root { --green-50: … }'

바꾸지 않는 것

  • 회색 11단계와 상태 색 — 화면이 달라도 「완료는 그린, 반려는 레드」라는 뜻은 같아야 해요.
  • 글자 크기·모서리·간격 — 밀도와 리듬이 시스템의 정체성이에요.
주 버튼 흰 글자 대비가 4.5:1에 못 미치면, 브랜드 예외로 기록하고 글자를 굵기 600으로 쓰세요. ZEST 그린(2.25:1)도 같은 규칙을 따라요.