rebuild the public site on the Next.js App Router with static export, per-section SEO pages, metadata, sitemap, robots and a generated OG image add full-screen scroll-snap regions, staged scroll reveals, a hash-free tab navigation with a sliding indicator and region-by-region menu scrolling replace the theme text toggle with animated sun/moon icons restructure the CRM API into config, middleware, models, routes, services and utils layers redesign the CRM shell with a single surface, tab rail, full-width blurred DataTable, record dialogs and mask-based icons update Docker/Nginx publishing, Makefile targets, shared UI polish and docs Co-authored-by: Gitea Actions <-[email protected]>
@cohaise/ui
Design system partagé de l'écosystème CoHaiSe. Point d'entrée unique des jetons de style
utilisés par frontend/web, frontend/crm et frontend/cloud, garantissant une identité visuelle
homogène et la thématisation dynamique clair/sombre.
Couche de jetons
Ce paquet expose une chaîne CSS en trois fichiers, du plus primitif au plus dérivé.
| Fichier | Rôle |
|---|---|
src/styles/tokens.css |
Variables CSS brutes (--cohaise-*). Échelle de gris en oklch, jetons sémantiques, ombres, typographie, rayons, courbes et durées de mouvement. |
src/styles/theme.css |
Directive @theme inline mappant les variables brutes vers les utilitaires Tailwind (bg-surface, text-muted-foreground, border-border...). |
src/styles/index.css |
Point d'entrée, importe les deux fichiers ci-dessus. |
Mouvement
Tailwind v4 ne réserve pas de namespace de thème aux durées : duration-* est un
utilitaire à valeur nue. Les trois durées sont donc exposées via @utility dans
theme.css, adossées aux jetons --cohaise-duration-*.
--default-transition-duration et --default-transition-timing-function sont
également déclarés, si bien que toute classe transition-* hérite du mouvement du
design system sans avoir à le répéter :
.transition-colors {
transition-timing-function: var(--tw-ease, var(--cohaise-ease-out-soft));
transition-duration: var(--tw-duration, var(--cohaise-duration-base));
}
Les utilitaires duration-fast, duration-base, duration-slow et ease-out-soft
surchargent ces valeurs au cas par cas.
Chaîne de résolution
flowchart TD
A["tokens.css<br/>--cohaise-gray-*, --cohaise-crimson-*"] --> B["tokens.css<br/>--cohaise-background, --cohaise-border, ..."]
B --> C["theme.css<br/>@theme inline"]
C --> D["Tailwind CSS<br/>compile les utilitaires"]
D --> E["frontend/web · frontend/crm · frontend/cloud"]
F["Classe .dark sur <html>"] -.->|surcharge les jetons sémantiques| B
L'échelle de gris et l'échelle carmin sont les seules sources de vérité des couleurs
brutes. Les jetons sémantiques n'y font référence que par var(), jamais par une valeur
littérale, sauf pour les statuts (success, warning, info) et l'ombre carmin, qui
n'existent que dans le mode sombre.
La source de vérité du rouge est --clr-accent du site, soit #b71c1c, et non le
carmin #c3073f qui apparaît davantage dans la feuille de style compilée. Les deux
valeurs ont été retenues à un moment de la construction du thème : le carmin est plus
vif, la valeur déclarée plus profonde et moins magenta. Sur un outil de gestion de
fichiers, c'est la seconde qui tient le mieux sur de grandes surfaces.
Couleurs
Les valeurs viennent de esiah.dev. Le fond sombre est un noir à dominante rouge
(#050000), pas un gris neutre, et l'accent est le carmin #b71c1c.
| Rôle | Clair | Sombre |
|---|---|---|
| Fond | #f7f5f4 |
#050000 |
| Surface | #ffffff |
#1a0505 |
| Surface surélevée | #ffffff |
#1e1e22 |
| Texte | #1a1a1a |
#f4f4f2 |
| Texte atténué | #5c5656 |
#a8a0a0 |
| Primaire | #b71c1c |
#b71c1c |
| Accent graphique | #b71c1c |
#c92a2a |
| Filet de séparation | #e8dcdc |
#2e1c1c |
Un seul rouge de marque dans les deux modes, ce qui rend les captures et les comparaisons d'écran reproductibles. Il n'est appliqué qu'en aplat plein, avec du texte blanc dessus, où il atteint 6,57:1.
accent-graphic est un ton séparé, réservé aux petits éléments posés sur une
surface : filet de carte, carré de liste, anneau de focus. Ces éléments sont lus comme
interface et relèvent du seuil de 3:1, or le rouge de marque ne donne que 2,65:1 sur la
surface sombre. Le même raisonnement impose une bordure de champ distincte, à 3,57:1 en
sombre et 3,73:1 en clair.
Le destructif est ambre, pas rouge. C'est une décision de lisibilité, pas un goût :
l'accent du site est un rouge, donc un bouton « supprimer » rouge serait confondu avec un
bouton d'accent. destructive occupe donc le ton oklch(0.768 0.188 70), déjà présent
dans la palette, et warning garde le jaune plus clair. Le prix à payer est que
« supprimer » et « attention » sont proches en teinte ; ils ne se croisent jamais dans le
même écran, et c'est un choix à revoir si l'interface grossit.
Les bordures de champs de formulaire ont leur propre jeton. Les bordures
décoratives restent très discrètes, 1.2:1 sur le fond en mode sombre, pour respecter le
grain du site. Un champ de formulaire doit en revanche pouvoir être identifié sans le
remplir ni le survoler, ce que la WCAG 1.4.11 chiffre à 3:1. border-control est
donc nettement plus clair, 3.5:1 en sombre et 3.7:1 en clair, et c'est lui que
Input utilise. Les deux valeurs ont été retenues en mesurant le contraste réel plutôt
qu'à l'œil.
Polices
| Usage | Police | Variable |
|---|---|---|
| Titres, libellés, boutons | Orbitron | --cohaise-font-display |
| Texte courant et paragraphes | Poppins | --cohaise-font-sans |
| Marque | Orbitron | --cohaise-font-logo |
| Accroche courte, registre éditorial | Cinzel | --cohaise-font-serif |
| Code | JetBrains Mono et replis | --cohaise-font-mono |
Le partage vient du site, où body est en Orbitron. Orbitron a une chasse très large : à
32 px, un titre paraît écrit à la main, et un mot-symbole doit être resserré pour ne pas
s'éparpiller. D'où quatre jetons d'interlettrage dédiés, dont un négatif pour les titres.
Orbitron est donc cantonnée aux chaînes courtes — titres jusqu'à h3, libellés en
capitales, boutons — avec tracking-label en positif. Au-delà de h3, la chasse est trop
large pour la taille du texte. Le flux est en Poppins. C'est pourquoi font-display est
appliqué dans la couche base plutôt que laissé au soin de chaque composant : c'est la
seule façon d'éviter qu'un titre revienne en Poppins parce qu'un écran l'a oublié.
Cinzel est conservée en réserve. C'est un bon caractère, mais une serif d'inscription romaine sur des libellés d'interface ou un paragraphe devient vite illisible, et c'est précisément ce qui donnait au premier jet de ce thème son aspect de thème généré.
Les trois faces sont auto-hébergées dans frontend/shared/fonts, 53,6 Ko au total,
soit 30 Ko de moins que Roboto seul. Un appel à Google Fonts aurait fait fuiter l'adresse
IP de chaque visiteur de ton NAS vers un tiers, ce qui n'a pas sa place dans un écosystème
privé.
Modes clair et sombre
Le mode est piloté par la classe .dark appliquée sur <html>. :root porte le mode
clair, .dark surcharge l'ensemble des jetons sémantiques. color-scheme est défini
sur les deux blocs pour aligner les contrôles natifs et les barres de défilement.
flowchart LR
subgraph Light["`:root` — mode clair"]
LA["--cohaise-background<br/>#f7f5f4"]
LB["--cohaise-foreground<br/>#1a1a1a"]
LC["--cohaise-primary<br/>#b71c1c"]
end
subgraph Dark["`.dark` — mode sombre"]
DA["--cohaise-background<br/>#050000"]
DB["--cohaise-foreground<br/>#f4f4f2"]
DC["--cohaise-primary<br/>#b71c1c"]
end
Light -->|bascule de classe| Dark
Aucune règle @media (prefers-color-scheme) n'est déclarée : la bascule est
explicite, ce qui garantit un comportement unique quelle que soit la préférence
système.
Forme
Les rayons sont quasi nuls, de 2 à 6 px, contre 4 à 12 px pour les valeurs par défaut de Tailwind. Les tuiles à coins arrondis sont la signature la plus immédiate d'une interface sans intention, et un registre d'instrument se lit dans l'angle autant que dans la couleur.
Trois marques complètent le registre : un filet carmin d'un pixel en tête de Card, un
carré plein de 6 px devant chaque élément de liste au lieu d'une puce ronde, et des
libellés en capitales espacées. Aucune n'est décorative au sens strict : elles servent à
séparer des blocs sans ajouter de bordure lourde, et à rendre les métriques denses
scannables.
Consommation
@import "tailwindcss";
@import "@cohaise/ui/styles";
L'application conserve la main sur la directive tailwindcss et sur sa configuration ;
ce paquet ne fournit que les jetons. Le build Vite résout l'entrée via le champ
exports du package.json.
Contraintes
- Aucune valeur de couleur littérale n'est autorisée dans les composants : uniquement des utilitaires derivés des jetons sémantiques, sinon la thématisation casse.
@theme inlineest obligatoire plutôt que@theme, car les utilitaires doivent référencer la variable pour résoudre la valeur au changement de mode.- Aucune durée ne doit être écrite en dur dans un composant (
duration-150est interdit) : passer parduration-fast,duration-baseouduration-slow.