ikie는 웹과 iPhone이 같은 앱이에요. 생김새는 플랫폼에 맞춰 달라도 되지만, 보라가 다른 보라이거나 시트가 다른 빠르기로 올라오면 같은 앱으로 느껴지지 않아요.
그래서 색·글자·간격·모서리·그림자·움직임을 토큰으로 한 곳에 적어요. 웹과 iOS는 그 값을 손으로 옮겨 적지 않고, 만들어진 파일을 불러 써요.
- 10/05 17:29토큰·부품·/design 참고 화면, 대비 시험과 화면 CSS 시험 (#31)
- 10/05 18:02iOS 문법으로 다시: Radix 색, Pretendard, 스프링 움직임 (#35)
- 10/05 22:50iOS 앱 뼈대가 같은 JSON에서 Tokens.swift를 받아요 (#49)
- 10/14시간 눈금 글자를 읽는 글로 보고 대비 규칙에 더해요 (#410)
- 10/17iOS 계산·쓰임새 층의 글자 숫자를 막아요 (#676)
원천은 JSON 하나
토큰은 W3C 디자인 토큰 형식(DTCG)의 JSON이에요. 밝은 색, 어두운 색, 나머지(글자·간격·움직임 등) 세 파일에 165개가 있어요. npm run tokens가 Style Dictionary로 두 파일을 만들어요.
- 원천
packages/tokens/tokens/*.json토큰 165개. 색은 Radix Colors 단계를 이름으로 가리키고, 값마다 어디에 쓰는지 설명이 붙어요.
- 웹
apps/web/app/tokens.cssCSS 변수. 밝은 모드가 기본이고, 기기가 어두운 모드거나 data-theme가 dark면 색만 바꿔요.
- iOS
apps/ios/Ikie/Design/Tokens.swiftSwiftUI 값. 색은 밝은·어두운 쌍, 움직임은 Animation.spring, 그림자는 한 겹으로 적어요.
- 참고 화면
/design토큰과 부품을 실제 CSS로 밝은·어두운 모드에 나란히 그려요. 새 부품은 여기에도 더해요.
iOS 앱은 만든 값을 이만큼 불러요.
색은 이름으로 불러요
색 토큰은 56개예요. 화면은 #6e56cf 같은 값이 아니라 accent(주 동작·고른 날·체크), quiet(보조 글자), now(지금 선) 같은 뜻 이름을 불러요. 뜻 이름은 다시 Radix Colors의 단계를 가리켜요. 직접 고른 색 단계를 만들지 않고, 밝은·어두운 짝과 단계별 쓰임이 정해진 오픈소스를 썼어요.
| 뜻 이름 | 쓰는 곳 | 밝은 모드 | 어두운 모드 |
|---|---|---|---|
| text | 본문 글자 | slate 12 | slate dark 12 |
| quiet | 보조 글자 | slate 11 | slate dark 11 |
| accent | 주 동작, 고른 날, 체크 | violet 9 | violet dark 9 |
| event | 캘린더 색이 없는 일정 블록 | violet 3 | violet dark 4 |
| sheet | 바텀 시트 바탕 | slate 3 | slate dark 2 |
56개 중 35개가 모드에 따라 바뀌어요. 밝은 모드 35개 중 31개, 어두운 모드 35개 중 33개가 Radix 단계를 가리키고, 나머지는 흰 바탕처럼 일부러 고른 값이에요. 브랜드 그라디언트나 설정 줄 앞의 색 아이콘 칸처럼 두 모드에서 같아야 하는 21개는 바꾸지 않아요. 시험은 "어두운 모드가 바꾸는 색"이 정확히 그 35개인지 봐요. 새 색을 더하고 어두운 값을 잊으면 막혀요.
대비는 시험이 재요
글자는 바탕과 4.5:1, 아이콘·선 같은 그림 요소는 3:1 이상이어야 해요(WCAG 2.2 1.4.3·1.4.11). 시험에는 "이 글자 색은 이 바탕들 위에 놓인다"는 짝이 48개 있고, 밝은·어두운 모드에서 모두 재요. 96번이에요.
규칙은 쓰면서 자랐어요. 처음에는 시간표의 시각 글자(9시, 10시…)에 faint를 썼어요. faint는 자리 표시·꺼진 것 같은 그림 요소용이라 3:1만 지켜요. 그런데 시각은 사람이 읽는 글이에요. 그래서 웹과 iOS 시간표의 시각 글자를 함께 quiet로 바꿔 4.5:1로 재게 했어요(#410). 같은 PR에서 quiet가 놓이는 바탕에 목록 줄 안의 꼬리표 바탕(badge)도 더했고, faint의 설명에는 "읽을 글에는 쓰지 않는다"고 적었어요.
어떤 색이 어디에 놓이는지는 짝으로 적고, 그 짝을 두 모드에서 잰다. 눈으로 보고 괜찮다고 하지 않는다.
움직임도 같은 스프링으로
iOS는 SwiftUI 스프링(response·dampingFraction)으로 움직여요. 웹 CSS에는 스프링이 없어요. 그래서 같은 스프링을 정해진 시간 동안 25점으로 뽑아 CSS linear() 곡선으로 적어요. 토큰 하나에 두 값이 함께 있어요. 웹은 곡선을, iOS는 스프링 값을 읽어요.
| 스프링 | SwiftUI 값 | 웹 길이 | 쓰는 곳 |
|---|---|---|---|
| snappy | response 0.3, damping 0.86 | 390ms | 고르기, 켜기 |
| smooth | response 0.45, damping 1 | 610ms | 자리 옮김 |
| bouncy | response 0.4, damping 0.7 | 590ms | 끝냄 체크 |
이 글을 쓰며 세 곡선을 스프링 식으로 다시 셈해 봤어요. 25점 모두 0.0005 안에서 같았어요(소수 셋째 자리 반올림 차이). 다만 그동안 이것을 지키는 시험은 없었어요. 곡선을 손으로 고치면 웹만 다르게 움직일 수 있었던 거예요. 그래서 시험을 더했어요. JSON의 스프링 값으로 곡선을 셈해 0.001보다 다르면 막아요. 스프링 값을 0.3에서 0.35로 바꿔 시험이 깨지는 것도 확인했어요.
움직임 줄이기를 켠 기기에서는 웹이 모든 길이 토큰을 0ms로 바꿔요. 화면마다 따로 끄지 않아도 돼요.
글자는 사람이 고른 크기를 따라요
글꼴은 Pretendard예요. 일본어·중국어 화면에서는 한자·가나 모양이 그 언어에 맞도록 그 언어의 Noto Sans를 뒤에 이어요. 같은 한자라도 언어마다 모양이 달라서요.
글자 크기는 JSON에 pt로 적어요. 웹은 rem으로 바꿔 브라우저의 기본 글자 크기 설정을 따르고, iOS는 글자 모양(본문·제목 등)에 붙여 Dynamic Type을 따라요. 간격과 칸 크기는 그대로 둬요. 두 앱 모두 글자만 커지고 틀은 그대로예요.
숫자를 쓰면 시험이 막아요
토큰이 있어도 화면에 숫자를 쓰기 시작하면 다시 흩어져요. 그래서 막는 시험을 뒀어요.
- 웹 화면 CSS: 색(
#hex,rgb(),oklch(),white)과 글자 크기·굵기를 숫자로 쓰면 막아요. - 없는 토큰:
var(--없는-이름)은 브라우저에서 조용히 빠져요. 화면이 부르는 CSS 변수가 모두 있는지 봐요. - 만든 파일: tokens.css와 Tokens.swift가 JSON에서 다시 만든 것과 글자 하나까지 같은지 봐요.
- iOS 계산·쓰임새 층: 숫자를 글자로 쓰면 막고, 남겨 둔 숫자는 파일마다 까닭을 적어요(그레고리력 셈, HTTP 상태 등).
iOS 화면 파일은 아직 시험이 숫자를 막지 않아요. 대부분 토큰을 부르지만, 숫자로 적은 간격·크기가 아직 남아 있어요. 다음에 막을 곳이에요.
배운 것
- 값은 한 곳에, 플랫폼 모양은 만드는 쪽에서. JSON은 플랫폼을 몰라요. rem, Animation.spring, 그림자 한 겹 같은 모양은 만드는 스크립트가 정해요.
- 이름은 뜻으로. 화면은 보라를 부르지 않고 "주 동작"을 불러요. 그래서 화면은 어두운 모드를 몰라도 되고, 색을 바꿀 때 화면을 뒤지지 않아요.
- "같아 보인다"도 재요. 대비도, 웹과 iOS의 움직임도 숫자로 견주면 시험이 될 수 있어요.
같은 일을 한 곳에서만 하는 설계 원칙 전체는 원칙 글에 있어요.