Files
CoHaiSe/docs/standards.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

3.3 KiB

Standards — CoHaiSe Web

Conventions à respecter pour que ce dépôt reste cohérent avec les deux autres (CoHaiSe-CLOUD, CoHaiSe-CRM), qui partagent le même design system.

Formatage

.editorconfig fait foi :

Réglage Valeur
Charset UTF-8, fin de ligne LF
Indentation 2 espaces (pas de tabs)
trim_trailing_whitespace false pour *.md, vrai ailleurs

Aucun Prettier/ESLint n'est installé : l'éditeur et l'.editorconfig sont la seule norme mécanique.

Palette

Source unique : frontend/shared/src/styles/tokens.css.

Jeton Rôle Valeur
--cohaise-accent accent de marque (liens, focus, éléments primaires) carmin #b71c1c (crimson-700)
--cohaise-destructive suppression, erreurs, champs invalides #d32f2f clair / #ef4444 sombre
--cohaise-destructive-foreground texte posé dessus #ffffff clair / #1a0505 sombre
--cohaise-warning avertissement, badges d'état jaune yellow-500
--cohaise-surface, --cohaise-background fonds gris chaud #f7f5f4 / #050000

Règles :

  • L'orange n'existe plus : --cohaise-amber-* a été retiré. Ne pas le réintroduire — le rouge a remplacé l'ambre sur le bouton destructif pour des raisons de contraste (≥4.5:1 en clair comme en sombre).
  • Ne pas dériver la palette dans un seul dépôt : tokens.css doit rester identique partout.
  • Toute nouvelle couleur doit être lisible comme texte sur le fond d'application ET comme fond avec un texte posé dessus. Vérifier les deux cas.

Typographies

Chargées en local (frontend/shared/fonts/*.woff2), jamais par CDN :

Usage Police
Texte courant Poppins 400/600
Titres display Orbitron, Cinzel
Code / monospace JetBrains Mono

Composants

@cohaise/ui expose Button, Card (+ sous-composants), Input, Skeleton, Spinner et l'utilitaire cn.

  • Un composant partagé ne doit pas connaître le métier d'une app.
  • Une variante visuelle propre à une app se développe dans cette app, pas dans frontend/shared.
  • Skeleton et Spinner sont prévus pour les états de chargement ; ne pas réinventer un spinner.

Thème

  • Bascule clair/sombre par la classe .dark sur <html>.
  • Script inline dans index.html (avant le bundle) : lit localStorage["cohaise-theme"], sinon prefers-color-scheme. C'est lui qui évite le flash de thème.
  • color-scheme: light dark déclaré pour les contrôles natifs.
  • Toute règle sombre va dans le bloc .dark de tokens.css, pas en @media (prefers-color-scheme: dark) : la préférence utilisateur prime.

Git

  • Branche main unique, remote origin sur git.cohaise.dev.
  • Pas de convention de message imposée par l'historique (dépôt neuf).
  • N'exclure de git que : .env* (sauf .env.example), node_modules/, dist/, *.log, backups/.
  • docs/ est versionné (la ligne docs/ de .gitignore a été retirée).

Interdépôts

Élément Attendu
frontend/shared/src/styles/tokens.css identique (même md5sum)
Composants @cohaise/ui dupliqués, peuvent diverger
Ports web 8080, CRM 8082, Cloud 8083
Remotes un dépôt Git autonome par app, aucun lien de code entre eux