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
| Role | Recommended Token | Usage |
|---|---|---|
| Page Background | --bg, --page-background | Page base color and overall space |
| Content Surface | --panel, --card-surface | Panels, content cards |
| Control Surface | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Buttons, search, input fields, and interaction states |
| Overlay Surface | --dropdown-surface, --dialog-surface | Menus, Popover, Dialog |
| Borders | --panel-border, --control-border, --input-border | Separators and state boundaries |
| Text | --text, --muted | Primary and secondary information |
| Brand Interaction | --accent, --link-color, --link-hover-color | Links, selection, and light emphasis |
| Keyboard Focus | --focus-ring | focus-visible state |
| Border Radius | --card-radius, --button-radius, --button-pill-radius | Card and control shapes |
| Button Font Size | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Shared button size-level typography |
| Fonts | --font-heading, --font-body | Headings 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, andlg, 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-surfaceto provide a slight vertical gradient, with border radius shared with Cards via--card-radius; --accentis used for links, focus, selection, and progress, not for large-area backgrounds;- Ordinary unselected controls use neutral
--control-surface-hoveron hover; pressed, selected, current, and expanded states use the brand wash--control-surface-active.focus-visiblekeeps 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.