Les fondations
Komi doit inspirer confiance sans devenir froid, et rester vivant sans devenir bruyant.
Comprendre avant d’impressionner
La hiérarchie doit rendre le prochain geste évident. L’expression visuelle soutient le contenu, jamais l’inverse.
Une profondeur qui explique
Une ombre ou un matériau signale un niveau fonctionnel. Sans hiérarchie réelle, le contenu reste ouvert et plat.
Accessible dès la première version
Contraste, clavier, focus, texte agrandi et mouvement réduit font partie du composant, pas de la finition.
Une personnalité tenue
Blanc, Funnel et touches de corail suffisent à signer Komi. Aucun effet décoratif ne doit lutter avec eux.
Couleurs sémantiques
On choisit une couleur pour son rôle. Une valeur hexadécimale ne doit jamais être recopiée dans un nouveau composant.
Corail
--km-coralAccent expressif, illustration et grands détails
#ff765dCorail profond
--km-coral-deepActions et liens sur fond clair
#c43d38Rose
--km-pinkAccent secondaire ponctuel
#ff68a5Rose clair
--km-roseSurface douce et sélection
#ffd7dfGris léger
--km-creamSurface secondaire neutre
#f7f7f5Gris de surface
--km-sandFond de média et zone secondaire
#efefedBlanc
--km-whiteSurface élevée et fond calme
#ffffffEncre
--km-inkTexte principal et contrôle sombre
#191919Nuit
--km-darkSurface de contraste ponctuelle
#171717Texte secondaire
--km-mutedTexte complémentaire sur fond clair
#646464Bordure
--km-lineSéparer discrètement les contenus
#e5e5e2L’orange est conservé uniquement pour les anciennes pages. Les nouvelles compositions utilisent le blanc, le noir, les gris, le corail et le rose.
Les voix de Komi
La typographie signale le contexte avant même que le texte soit lu.
Votre campus accessible.
Poids 400, 600 et 700. Interlettrage de -0,02 à -0,06 em. Titres courts, deux lignes pour le hero.
Une seule plateforme pour comprendre, découvrir et activer tout votre campus.
Corps de 16 à 20 px. Interligne de 1,5 à 1,65. UI de 13 à 16 px. Les petits labels ne portent jamais la promesse principale.
tout est là
Rare et décorative. Jamais de navigation, de paragraphes longs, de chiffres importants ou de CTA.
Titres : 8 mots recommandés, 12 maximum.
Paragraphes : 65 à 75 caractères par ligne.
Petit texte : 12 px minimum, 13 px pour une information utile.
Le vivant, par touches.
Le fonctionnel reste net. Les photos, les annotations et la matière apportent la vie.

majoritaire.
Un ou deux moments de gradient corail et rose. Une matière légère, jamais un fond permanent.
- Le logo officiel reste intact. Les photos servent la narration.
- Bristol et les décalages sont rares, décoratifs et supprimables sur mobile.
- Aucun violet, bleu IA, effet vitré systématique ou illustration abstraite de remplissage.
- Aucun témoignage, chiffre ou logo client sans source vérifiée.
Rythme et mise en page
La grille donne de la stabilité. Les décalages créent la personnalité uniquement quand ils servent la lecture.
- Section desktop
- 88 à 148 px
- Section mobile
- 64 à 82 px
- Gouttière desktop
- 24 px minimum
- Gouttière mobile
- 16 px minimum
--km-space-1--km-space-2--km-space-3--km-space-4--km-space-6--km-space-8--km-space-12--km-space-16--km-space-24--km-space-3212 px
Champs, contrôles et petites surfaces.
20 px
Cartes utiles et panneaux principaux.
28 px
Médias et grands moments éditoriaux.
Pilule
Badges, filtres et actions compactes uniquement.
- Utiliser la grille pour aligner les contenus qui se répondent.
- Laisser plus d’espace avant un titre qu’après lui.
- Éviter trois cartes identiques quand une liste ouverte suffit.
- Ne jamais créer une valeur d’espacement isolée sans raison mesurable.
Compositions de l’application
La référence interactive rassemble l’écran canonique, le catalogue des widgets et leurs variantes clair et sombre.
Composants de base
Une même apparence implique le même comportement. Les exemples ci-dessous sont les contrats à réutiliser.
Boutons
Une action principale par zone. Le libellé commence par un verbe et tient sur une ligne.
className="km-button km-button-primary"Onglets & filtres
Un onglet sélectionne une vue. Un filtre choisit le contenu. Les deux restent compacts, en pills.
Onglets : un seul actif. Flèches gauche et droite, Home et End. Le panneau est lié à son onglet.
Filtres : sélection lisible et état aria-pressed. Les intérêts peuvent se combiner.
Mobile : compacter le hero ; autoriser le retour à la ligne pour les audiences et les intérêts.
Filtres · marketing/site/tabs.tsxChamp de formulaire
Le label reste visible. L’aide précède l’erreur et le placeholder ne remplace jamais le label.
Le mouvement confirme
Une animation doit expliquer une relation, un changement d’état ou la conséquence d’un geste.
Réponse immédiateOuvrez ce composant au clic ou au clavier
Le contenu apparaît immédiatement. Le geste contrôle le mouvement.
--km-duration-fast : 160 ms pour les contrôles.
--km-duration : 240 ms pour les changements de contenu.
--km-ease-fluid : cubic-bezier(0.16, 1, 0.3, 1).
L’autoplay du hero s’arrête au focus, au survol, en arrière-plan et avec le mouvement réduit. Après interaction : pause de 30 secondes.
Entrée
Partir de la position visible. 160 à 240 ms, sans délai artificiel.
Interaction
Répondre dès l’appui. Utiliser un ressort sans rebond pour les contrôles usuels.
Sortie
Reprendre le chemin d’entrée et rester interruptible à tout moment.
Réduction
Remplacer translation et parallaxe par un changement instantané ou un fondu court.
L’accessibilité est un état normal
Le design Komi doit fonctionner sans souris, sans animation et avec une lecture agrandie.
Contraste minimum du texte courant et des libellés de contrôle.
Contraste minimum du grand texte et des limites d’un composant.
Taille tactile minimale, même si l’icône visible est plus petite.
Zoom supporté sans perte d’information ni chevauchement.
- Focus visible sur chaque élément interactif.
- Ordre du DOM identique à l’ordre de lecture.
- États transmis par du texte, pas par la couleur seule.
- Messages d’erreur placés près du champ concerné.
Essayez avec la touche Tab
Lien avec focus KomiUn système, plusieurs contextes
Les surfaces partagent la marque, mais pas la même densité. Chaque règle reste dans son périmètre CSS.
| Scope | Surface | Source | Règle |
|---|---|---|---|
.km-site | Site public | marketing.css + brand-system.css | Blanc dominant, Funnel Sans, expression éditoriale. |
.kr-site | Ressources | resources.css | Lecture longue, recherche et contenu éditorial. |
.komi-app-shell | Application web | app-design-tokens.css + app-shell.tsx | Même shell, composants et thèmes pour les parcours étudiants et administration. |
Chercher un token, un composant ou un motif existant avant d’ajouter du CSS.
Une valeur utilisée une seule fois reste dans le composant si elle décrit sa géométrie propre.
Créer un token après trois usages cohérents ou dès qu’un contrat traverse plusieurs surfaces.
Supprimer le doublon dans la même livraison. Deux sources de vérité ne sont jamais acceptées.
Avant chaque livraison
Cette checklist est le seuil minimum. Une page non vérifiée n’est pas une page terminée.
- Un seul H1, une hiérarchie de titres sans saut de niveau.
- Le corail profond porte les petites actions, jamais le corail clair.
- Chaque contrôle interactif mesure au moins 44 px sur son axe tactile.
- Tous les états ont été prévus : repos, survol, focus, actif, désactivé et erreur.
- La lecture reste confortable à 200 % de zoom et sur 320 px de large.
- Les images ont une taille réservée, un texte alternatif utile ou un alt vide si elles décorent.
- Le mouvement ne modifie que transform et opacity, sauf effet matériel justifié.
- prefers-reduced-motion conserve le sens sans translation ni parallaxe.
- Aucune nouvelle couleur, ombre ou forme ne duplique un token existant.
- La page a été vérifiée au clavier, en mobile et dans son contexte réel.
La cohérence vient des décisions répétées.
Quand une règle ne couvre pas un besoin réel, documentez d’abord l’exception. Ensuite seulement, faites évoluer le système.