# @cohaise/web
Vitrine institutionnelle de `cohaise.dev`, en Next.js 16 (app router, export
statique). Ses routes sont servies par nginx : aucun serveur Node en production.
## Rôle
| Responsabilité | Localisation |
| --- | --- |
| Design system, jetons, composants | `frontend/shared` |
| Vitrine institutionnelle | `frontend/web` |
| Publication des builds | `docker/` |
```mermaid
flowchart LR
subgraph navigateur
app["frontend/web
Next.js (export statique)"]
end
subgraph monorepo
ui["frontend/shared
@cohaise/ui"]
end
subgraph infrastructure
web["nginx
cohaise.dev"]
end
app -->|import| ui
app -->|out/| web
```
## Prérequis
- Node.js `>=22.23.1`
- npm `>=10`
## Commandes
| Commande | Effet |
| --- | --- |
| `npm run dev -w @cohaise/web` | serveur Next sur `http://localhost:3000` |
| `npm run build -w @cohaise/web` | build de production dans `out/` |
| `npm run typecheck -w @cohaise/web` | vérification de types seule |
| `make web` | construit l'image et republie le build dans le volume nginx |
Le premier build de la vitrine exige que `frontend/shared` soit construit :
`npm run build` à la racine exécute `tsc --build` avant les workspaces.
## Routes
| Route | Contenu |
| --- | --- |
| `/` | accueil : Hero + toutes les sections, JSON-LD |
| `/services` | développement web, mobile, UI/UX, logiciels sur mesure |
| `/demos` | CRM, inventaire IT, gamification scolaire |
| `/stack` | technologies utilisées |
| `/about` | présentation |
| `/contact` | formulaire de contact → `POST /api/crm/leads` |
| `/sitemap.xml` | généré depuis `app/lib/site.ts` |
| `/robots.txt` | généré par `app/robots.ts` |
| `/opengraph-image` | image 1200×630 générée par `app/opengraph-image.tsx` |
## SEO
- `app/layout.tsx` : métadonnées par défaut, canonical, OpenGraph, Twitter,
icônes, `metadataBase`.
- Chaque page exporte son propre `metadata` (titre, description, canonical).
- L'accueil injecte un JSON-LD `Organization`, `WebSite` et
`ProfessionalService`.
- Le HTML prérendu est en **français** : le toggle FR/EN est purement client et
ne change pas l'URL indexée.
## Animations et défilement
- Chaque section est une région d'un écran (``, `min-h-dvh`,
`data-region`). Sur l'accueil, Stack et About partagent la même région.
- `app/globals.css` : `scroll-snap-type: y mandatory` +
`scroll-snap-stop: always` sur `main[data-scroll-snap] > section[data-region]`.
On ne peut donc pas s'arrêter entre deux régions, ni en sauter une d'un
geste. Le footer s'aligne sur la fin du viewport (`scroll-snap-align: end`)
pour rester atteignable. Snap désactivé en `prefers-reduced-motion`, sous
620 px de haut, et dès qu'une région dépasse l'écran (`html[data-snap="off"]`,
posé par `useScrollReveal`) pour ne jamais bloquer son contenu.
- `app/hooks/useScrollReveal.ts` observe chaque région via une bande centrale
du viewport. Après 0,25 s d'arrêt sur la région, ses `[data-reveal]`
apparaissent en cascade (`data-reveal-delay` pour le décalage, le hero est
à 0,2 s). Quitter la région avant la fin annule le minuteur.
- `app/globals.css` définit `.reveal-init` / `.is-revealed` (fade-in-up).
- Le contenu reste visible sans JavaScript ; `prefers-reduced-motion` désactive
les animations et le scroll-snap.
## Thème et langue
- Thème : script inline dans `app/layout.tsx` (anti-FOUC), état lu après montage
par `ThemeContext`, persisté sous `cohaise-theme`.
- Langue : `LanguageContext`, français au premier rendu, préférence persistée
sous `cohaise-lang` puis appliquée après hydratation.
## Structure
```text
frontend/web
├── app
│ ├── layout.tsx shell, providers, métadonnées, script thème
│ ├── page.tsx accueil + JSON-LD
│ ├── globals.css Tailwind, régions (snap), reveal
│ ├── providers.tsx
│ ├── components/ Section (région), Header, Hero, Services,
│ │ Demos, StackAbout, Contact, Footer,
│ │ Background, ScrollReveal…
│ │ └── background/ Topography (WebGL, client uniquement)
│ ├── contexts/ LanguageContext, ThemeContext
│ ├── data/ services, demos, stack
│ ├── hooks/ useScrollReveal
│ ├── lib/ site, api, gsap
│ ├── services/ … une page par dossier
│ ├── sitemap.ts, robots.ts, opengraph-image.tsx
│ └── not-found.tsx
├── public/ favicon, images
├── next.config.ts export statique, trailingSlash
├── postcss.config.mjs
└── tsconfig.json
```
## Variables d'environnement
| Variable | Usage |
| --- | --- |
| `NEXT_PUBLIC_CRM_API_URL` | URL de l'API CRM au build (défaut : `https://crm.cohaise.dev`, ou `http://localhost:8082` en local) |
Seules les variables préfixées par `NEXT_PUBLIC_` sont exposées au navigateur.
Aucun secret ne doit jamais être lu par le front.
## Limites
- Export statique : pas de route dynamique serveur, pas d'optimisation d'image
Next (`images.unoptimized: true`).
- Le fond WebGL et les animations sont chargés côté client uniquement.
- Les tests navigateur réels (hydratation, WebGL, reveals) restent manuels.