1. 설계 원칙과 토큰 구조
1-1. 브랜드 3축
제니트리 UI가 말해야 하는 것: 전문성 · 신뢰감 · 피부 과학(Skin Science).
| 원칙 | 뜻 | 화면에서 |
|---|---|---|
| 깔끔함(Clean) | 여백이 정보다 | 넉넉한 여백, 얇은 구분선, 낮은 채도 배경 |
| 세련됨(Refined) | 과장 없는 정밀함 | 절제된 색, 미세한 그림자, 정연한 그리드 |
| 섬세함(Delicate) | 신뢰를 만드는 디테일 | 부드러운 모션, 정확한 정렬, 자릿수 맞는 숫자 |
색을 남발하지 않습니다. 뉴트럴(먹색·회색)이 화면의 90%, 색은 의미가 있을 때만 씁니다.
1-2. 토큰 4계층
값을 하나하나 정하지 않고 파생 규칙으로 관리합니다. 앱이 늘어나도 어긋나지 않는 이유입니다.
Seed Token 씨앗 — 디렉터가 정하는 최소 원점 (대표색·기준 크기·폰트)
│ ▼ 규칙대로 자동 파생
Map Token 계단 — 색 팔레트(50~900)·타입·간격·라운드·레이어 스케일
│ ▼ 용도 이름을 붙임
Alias Token 의미 이름 — 본문색·배경색·테두리색 … 라이트/다크가 여기서 갈림
│ ▼
Component 버튼·표·탭 — Alias만 참조. 앱은 --jt-* 노브로만 조정 (§12-0 계약)개발자는 Alias만 쓰면 됩니다. 계단 값을 외울 필요가 없고, 라이트/다크/밀도 전환이 자동으로 됩니다.
1-3. 정본 파일 구성 (v5.0 신설)
v4.0까지는 이 문서가 값·설명·코드를 전부 안고 있었습니다. 그러다 보니 문서와 실제 CSS가 어긋났습니다(§17-7 어긋남 4건). v5.0부터 역할을 나눕니다.
| 파일 | 역할 | 편집 권한 |
|---|---|---|
| 이 문서 (DS v5.0) | 왜 이 값인가 · 규칙 · 계약 · 절차 | 디렉터 |
jt-tokens.css | 값의 정본. 모든 CSS 변수 + 웹폰트 로드 | 디렉터 (앱은 편집 금지) |
jt-utilities.css | 코드의 정본. .jt-* 컴포넌트 클래스 | 디렉터 (앱은 편집 금지) |
COMPONENTS.md | 컴포넌트별 사용법·복붙 코드·하지 말 것 | 디렉터 |
TOOLCHAIN.md | Stitch → Antigravity 등 툴 이동 시 에러 방지 | 디렉터 |
JT_결정로그.md | 어느 대화에서 나온 결정이든 여기에 적립 | 전체 |
규칙: 값이 이 문서와 jt-tokens.css에서 다르면, 항상 jt-tokens.css가 맞습니다. 이 문서에서 값을 발견하면 그것은 설명용 발췌입니다.