시각적 기반과 토큰
Qokit 브랜드 색상, 글꼴, 간격, 모서리 곡률 및 시맨틱 토큰의 공개 사용 계약.
시각적 기반과 토큰
Qokit 플랫폼 인터페이스는 투명하고 전문적이며 절제된 블루 계열을 사용합니다. 개발자는 시맨틱 토큰을 통해 테마를 적응시켜야 하며, 비즈니스 컴포넌트에서 색상 값, 그림자, 모서리 곡률 또는 글꼴을 복제하지 않아야 합니다.
핵심 역할
| 역할 | 권장 토큰 | 용도 |
|---|---|---|
| 페이지 배경 | --bg, --page-background | 페이지 바닥색 및 전체 공간 |
| 콘텐츠 표면 | --panel, --card-surface | 패널, 콘텐츠 카드 |
| 컨트롤 표면 | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | 버튼, 검색, 입력창 및 상호작용 상태 |
| 플로팅 표면 | --dropdown-surface, --dialog-surface | 메뉴, Popover, Dialog |
| 경계 | --panel-border, --control-border, --input-border | 구분 및 상태 경계 |
| 텍스트 | --text, --muted | 주요 및 보조 정보 |
| 브랜드 상호작용 | --accent, --link-color, --link-hover-color | 링크, 선택 및 경량 강조 |
| 키보드 포커스 | --focus-ring | focus-visible 상태 |
| 모서리 곡률 | --card-radius, --button-radius, --button-pill-radius | Card 및 컨트롤 형태 |
| 버튼 글꼴 크기 | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | 공유 버튼의 크기별 타이포그래피 |
| 글꼴 | --font-heading, --font-body | 제목 및 본문/컨트롤 |
타이포그래피
- Space Grotesk는 브랜드 제목, 페이지 제목 및 주요 숫자에 사용됩니다.
- Manrope는 본문, 버튼, 폼, 테이블 및 작업 공간에 사용됩니다.
- 작업 공간은 컴팩트하게 유지하며 마케팅 페이지 규모의 큰 제목을 사용하지 않습니다.
- 중국어는 영문식 자간을 늘리지 않으며, 긴 번역문이 인접한 작업을 압축하지 않도록 합니다.
간격 및 치수
- 4px 리듬 사용: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- 컴팩트 컨트롤의 클릭 높이는 40px 이상이어야 합니다.
- 기본 작업 높이는 44px이며, 모바일 주요 작업은 44px 이상이어야 합니다.
- 공유 버튼은
sm,md,lg에 따라 각각 14px, 15px, 16px 텍스트를 사용하며, 속한 컨테이너의 글꼴 크기를 상속받지 않습니다. - 플랫폼 콘텐츠 너비는 일반적으로 1160px를 초과하지 않으며, 생성된 사이트 콘텐츠는 일반적으로 1120px를 초과하지 않습니다.
테마 규칙
- 라이트 모드와 다크 모드 테마는 동일한 시맨틱 토큰을 재사용해야 합니다.
- 일반 Dialog는
--dialog-surface를 사용하여 미세한 세로 그라데이션을 제공하며, 모서리 곡률은 Card와--card-radius를 공유합니다. --accent는 링크, 포커스, 선택 및 진행 상황에 사용되며, 넓은 영역의 바닥색으로 사용하지 않습니다.- 일반적인 미선택 컨트롤은 hover에 중립 표면
--control-surface-hover를 사용하고, 눌림·선택·현재·확장 상태는 브랜드 표면--control-surface-active를 사용합니다.focus-visible은 중립 표면에--focus-ring을 추가하며, 포커스되거나 활성화된 입력은 입력 상태 Token을 유지합니다. - 상태 색상은 성공, 경고 및 위험만 표현합니다.
- 생성된 사이트는 테마 변수를 덮어쓸 수 있지만, 본문 대비율과 명확한 CTA 계층 구조를 유지해야 합니다.