Skip to Content
Design

Visual Foundations & Tokens

The public usage contract for Qokit brand colors, typography, spacing, border radius, and semantic tokens.

Visual Foundations & Tokens

The Qokit platform interface uses a clear, professional, and restrained blue palette. Developers should adapt themes via semantic tokens and avoid duplicating color values, shadows, border radii, or fonts in business components.

Core Roles

RoleRecommended TokenUsage
Page Background--bg, --page-backgroundPage base color and overall space
Content Surface--panel, --card-surfacePanels, content cards
Control Surface--control-surface, --control-surface-hover, --control-surface-active, --input-surfaceButtons, search, input fields, and interaction states
Overlay Surface--dropdown-surface, --dialog-surfaceMenus, Popover, Dialog
Borders--panel-border, --control-border, --input-borderSeparators and state boundaries
Text--text, --mutedPrimary and secondary information
Brand Interaction--accent, --link-color, --link-hover-colorLinks, selection, and light emphasis
Keyboard Focus--focus-ringfocus-visible state
Border Radius--card-radius, --button-radius, --button-pill-radiusCard and control shapes
Button Font Size--button-font-size-sm, --button-font-size-md, --button-font-size-lgShared button size-level typography
Fonts--font-heading, --font-bodyHeadings and body/control text

Typography

  • Space Grotesk is used for brand headings, page titles, and key numbers;
  • Manrope is used for body text, buttons, forms, tables, and workspaces;
  • Workspaces remain compact, avoiding large heading scales used in marketing pages;
  • Chinese text does not increase letter-spacing like English; long translations must not squeeze adjacent actions.

Spacing & Dimensions

  • Use a 4px rhythm: 8, 12, 16, 20, 24, 32, 48, 64, 96;
  • Compact controls must have a click height of no less than 40px;
  • Default action height is 44px; primary mobile actions must be no less than 44px;
  • Shared buttons use 14px, 15px, and 16px text respectively for sm, md, and lg, without inheriting the font size of their container;
  • Platform content width typically does not exceed 1160px; generated site content typically does not exceed 1120px.

Theme Rules

  • Light and dark themes must reuse the same semantic tokens;
  • Standard Dialogs use --dialog-surface to provide a slight vertical gradient, with border radius shared with Cards via --card-radius;
  • --accent is used for links, focus, selection, and progress, not for large-area backgrounds;
  • Ordinary unselected controls use neutral --control-surface-hover on hover; pressed, selected, current, and expanded states use the brand wash --control-surface-active. focus-visible keeps the neutral surface and adds --focus-ring; focused or active inputs keep their input-state tokens;
  • Status colors only express success, warning, and danger;
  • Generated sites can override theme variables but must maintain body text contrast and clear CTA hierarchy.

On this page