원칙

제품 화면과 컴포넌트를 일관되게 판단하는 다섯 가지 기준입니다.

먼저 이해되어야 합니다

작은 화면에서도 제목, 설명, 다음 행동의 순서가 즉시 보여야 합니다. 장식보다 정보 위계를 먼저 설계합니다.

한 화면의 주 행동은 하나입니다

가장 중요한 행동만 강하게 표시하고 보조 행동은 시각적 무게를 낮춥니다.

의미 토큰으로 표현합니다

제품 UI는 원시 색상 값이 아니라 color/action/primary, color/text/secondary처럼 역할을 말하는 토큰을 사용합니다.

기본 웹 의미를 보존합니다

버튼은 button, 입력은 input을 사용합니다. 키보드, 초점, 이름, 오류 연결은 시각 스타일과 같은 수준의 계약입니다.

플랫폼 차이는 실제 차이만 기록합니다

React와 Svelte는 같은 웹 계약을 공유합니다. React Native에서 동작이나 표현이 실제로 달라질 때만 차이를 추가합니다.