@cohaise/web
Vitrine institutionnelle de cohaise.dev. Première application du monorepo CoHaiSe et premier consommateur réel du design system partagé.
Rôle
| Responsabilité | Localisation |
|---|---|
| Design system, jetons, composants | frontend/shared |
| vitrine institutionnelle | frontend/web |
| Point d'entrée local, publication des builds | docker/nginx |
flowchart LR
subgraph navigateur
app["frontend/web<br/>React + Vite"]
end
subgraph monorepo
ui["frontend/shared<br/>@cohaise/ui"]
end
subgraph infrastructure
web["nginx<br/>cohaise.dev"]
end
app -->|import| ui
app -->|build statique| web
Prérequis
- Node.js
>=22.23.1 - npm
>=10
Commandes
| Commande | Effet |
|---|---|
npm run dev -w @cohaise/web |
serveur Vite sur http://localhost:5173 |
npm run build -w @cohaise/web |
vérification de types puis build de production dans dist/ |
npm run preview -w @cohaise/web |
sert le build de production localement |
npm run typecheck -w @cohaise/web |
vérification de types seule |
make web |
construit l'image et republie le build dans le volume Nginx |
Publication dans l'infrastructure
Le Dockerfile est un build multi-étapes. Le contexte de construction est la racine du
monorepo, car le build a besoin des workspaces, du lockfile et des références
TypeScript partagées.
node:22-alpine deps installation déterministe via npm ci
node:22-alpine builder tsc --build puis vite build
alpine:3.21 export /app/dist, copié dans le volume web_data
Le service cohaise-web-build copie le résultat dans le volume web_data, que Nginx
monte déjà sur /usr/share/nginx/html/web. Aucune modification de la configuration
Nginx n'est nécessaire, et la publication reste découplée des autres applications.
Consommation du design system
L'application importe la feuille de style publique du package partagé une seule fois, dans src/styles/index.css :
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/shared/src";
La directive @source est indispensable. Sans elle, Tailwind ignore node_modules et les classes utilisées par les composants de frontend/shared ne sont jamais générées : les composants s'afficheraient sans style.
Thème
Le thème est appliqué par la classe dark sur <html>. Le script inline de index.html applique la préférence enregistrée ou celle du système avant le premier rendu, ce qui évite le flash de thème clair. src/hooks/useTheme.ts pilote le changement et persiste le choix dans localStorage sous la clé cohaise-theme.
Structure
frontend/web
├── index.html amorce de thème et point de montage
├── public/favicon.webp
├── src
│ ├── App.tsx composition de la page
│ ├── main.tsx point d'entrée React
│ ├── components
│ │ ├── DemoCard.tsx états repos, chargement, chargé
│ │ └── ThemeToggle.tsx
│ ├── hooks
│ │ └── useTheme.ts
│ └── styles/index.css import du design system
├── tsconfig.json
├── tsconfig.node.json
└── vite.config.ts
Limites actuelles
- Aucun appel réseau : toutes les données de démonstration sont locales.
- Aucun routage : la page est un point d'entrée unique.
- Les URL d'API devront passer par un wrapper dédié, jamais codées en dur dans les composants.
Variables d'environnement
L'application ne déclare aucune variable pour l'instant. Le gabarit frontend/web/.env.example
prendra une entrée VITE_API_BASE_URL au moment où le premier appel réseau existera, afin
que l'URL reste définie à un seul endroit. Seules les variables préfixées par VITE_ sont
exposées au bundle ; aucun secret ne doit jamais être lu par le navigateur.