도움말

자주 묻는 질문

문서의 값과 CSS 파일의 값이 다릅니다. 어느 게 맞나요? 파일이 맞습니다. jt-tokens.css가 값의 정본이고, 이 사이트의 표는 “왜 이 값인가”를 설명하는 발췌입니다.

우리 앱만 버튼을 크게 하고 싶습니다. jt-utilities.css를 고치지 말고 노브를 덮어쓰세요. .my-page .jt-btn { --jt-btn-min-w: 120px; } → 컴포넌트 계약

필요한 컴포넌트가 없습니다. 먼저 대체 가능한지 확인하세요. 그래도 없으면 아래 “새 컴포넌트 요청”으로 제안해 주세요.

필요한 색·크기가 토큰에 없습니다. 지어내지 마세요. 그 순간 어긋남이 시작됩니다. 디렉터에게 요청하면 토큰에 먼저 추가한 뒤 쓰게 됩니다(역순 금지).

사내망에서 CDN이 막혀 폰트·아이콘이 안 뜹니다. 폰트는 자체 호스팅하고, 아이콘은 SVG 방식(.jt-ico-mask)을 쓰세요. 핵심 29종이 /brand/icons/에 있습니다.

기존 앱이 14px 기준입니다. 16px로 바꾸면 다 커지는데요? 정상입니다. 전역으로 줄이지 말고, 데이터 밀집 화면만 [data-density="compact"]를 그 영역에 거세요.

새 컴포넌트·토큰 요청하기

제안할 때 이 네 가지를 함께 적어 주세요. 없으면 판단할 수 없습니다.

1. 어느 화면에서 필요한가 (스크린샷이면 더 좋습니다)
2. 기존 것으로 왜 안 되는가
3. 다른 앱에서도 쓸 것 같은가 (한 곳에서만 쓰면 앱 소관입니다)
4. 초안이 있으면 코드나 그림

거버넌스 — 누가 무엇을 바꿀 수 있나

17-1. 변경 권한

17-2. 버전 규칙

호환성 원칙: MINOR 업데이트는 기존 화면을 절대 깨뜨리지 않습니다. 토큰을 없애야 할 때는 즉시 삭제하지 않고 한 버전 동안 유지 + 폐기 예정 표시(@deprecated) 후 다음 MAJOR에서 제거합니다. v5.0 현재 --fs-2xs가 여기에 해당합니다.

결정로그

v4.0까지 반복된 실제 문제: 대화에서 중요한 결정(예: “keep-all을 한국어에만 적용”)이 나와도, 그 결정이 정본 파일과 이 문서에 반영되지 않은 채 잊혔습니다. 그 결과 CI 문서·토큰 파일·이 문서의 값이 서로 다른 어긋남이 4건 발생했습니다.

운영 규칙

1. 어느 대화에서든 디자인 시스템·브랜드 관련 결정이 나면 JT_결정로그.md에 한 줄 적립합니다.
2. 버전 개정 작업 시 로그를 처음부터 훑으며 “반영됨” 표시가 없는 항목을 전부 반영합니다.
3. 결정은 삭제하지 않습니다. 뒤집힌 결정은 새 줄로 추가하고 이전 줄에 “폐기(→#n)“를 표시합니다.
4. 로그에는 미해소 충돌 목록도 함께 관리합니다.

v5.0은 이 로그의 37개 항목을 전부 반영해 만들어졌습니다.

남은 미해소 충돌 (다음 CI 개정 시 처리)