# 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 ``. - 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 |