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

@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.