Visuele basis en Tokens
Het open contract voor het gebruik van Qokit-merkkleuren, lettertypen, ruimtes, hoekstralen en semantische tokens.
Visuele basis en Tokens
De platforminterface van Qokit maakt gebruik van een helder, professioneel en ingetogen blauw kleurensysteem. Ontwikkelaars moeten thema's aanpassen via semantische tokens en geen kleurwaarden, schaduwen, hoekstralen of lettertypen kopiëren in bedrijfscomponenten.
Kernrollen
| Rol | Aanbevolen Token | Gebruik |
|---|---|---|
| Paginaachtergrond | --bg, --page-background | Paginabodem en algemene ruimte |
| Inhoudsoppervlak | --panel, --card-surface | Panelen, inhoudskaarten |
| Besturingsoppervlak | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Knoppen, zoeken, invoervelden en interactiestaten |
| Overlayoppervlak | --dropdown-surface, --dialog-surface | Menu's, Popover, Dialog |
| Grenzen | --panel-border, --control-border, --input-border | Scheidingen en statusgrenzen |
| Tekst | --text, --muted | Primaire en secundaire informatie |
| Merkinteractie | --accent, --link-color, --link-hover-color | Links, selectie en lichte accenten |
| Toetsenbordfocus | --focus-ring | focus-visible status |
| Hoekstralen | --card-radius, --button-radius, --button-pill-radius | Vormgeving van Cards en besturingselementen |
| Knoplettergrootte | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Gedeelde typografische niveaus voor knoppen |
| Lettertype | --font-heading, --font-body | Kopteksten en hoofdtekst/besturingselementen |
Typografie
- Space Grotesk wordt gebruikt voor merk- en paginakoppen en belangrijke getallen;
- Manrope wordt gebruikt voor hoofdtekst, knoppen, formulieren, tabellen en werkruimten;
- Werkruimten blijven compact; er worden geen grote koppen gebruikt zoals op marketingpagina's;
- Bij Chinese tekst wordt geen Engelse brede letterafstand toegepast; lange vertalingen mogen aangrenzende acties niet samendrukken.
Ruimte en afmetingen
- Gebruik een ritme van 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- De klikhoogte van compacte besturingselementen is minimaal 40px;
- De standaard actieve hoogte is 44px; primaire mobiele acties zijn minimaal 44px;
- Gedeelde knoppen gebruiken respectievelijk 14px, 15px en 16px tekst bij
sm,mdenlg, zonder overerving van de lettergrootte van de container; - De breedte van platforminhoud is meestal maximaal 1160px; gegenereerde site-inhoud is meestal maximaal 1120px.
Themaregels
- Lichte en donkere thema's moeten dezelfde semantische tokens hergebruiken;
- Standaard Dialogs gebruiken
--dialog-surfacevoor een lichte verticale verloopkleur; de hoekstraal is gedeeld met Cards via--card-radius; --accentwordt gebruikt voor links, focus, selectie en voortgang, niet voor grote achtergrondvullingen;- Gewone niet-geselecteerde besturingselementen gebruiken bij hover het neutrale
--control-surface-hover; ingedrukte, geselecteerde, huidige en uitgeklapte staten gebruiken het merkoppervlak--control-surface-active.focus-visiblevoegt--focus-ringtoe op het neutrale oppervlak; gefocuste of actieve invoervelden behouden hun invoerstatus-Token; - Statuskleuren geven alleen succes, waarschuwing en gevaar weer;
- Gegenereerde sites kunnen themavariabelen overschrijven, maar moeten de contrastverhouding van de hoofdtekst en een duidelijke CTA-hiërarchie behouden.