3.3 KiB
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.cssdoit 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. SkeletonetSpinnersont prévus pour les états de chargement ; ne pas réinventer un spinner.
Thème
- Bascule clair/sombre par la classe
.darksur<html>. - Script inline dans
index.html(avant le bundle) : litlocalStorage["cohaise-theme"], sinonprefers-color-scheme. C'est lui qui évite le flash de thème. color-scheme: light darkdéclaré pour les contrôles natifs.- Toute règle sombre va dans le bloc
.darkdetokens.css, pas en@media (prefers-color-scheme: dark): la préférence utilisateur prime.
Git
- Branche
mainunique, remoteoriginsurgit.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 lignedocs/de.gitignorea é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 |