deploy / deploy (push) Successful in 1m24s
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]>
5.3 KiB
5.3 KiB
@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/ |
flowchart LR
subgraph navigateur
app["frontend/web<br/>Next.js (export statique)"]
end
subgraph monorepo
ui["frontend/shared<br/>@cohaise/ui"]
end
subgraph infrastructure
web["nginx<br/>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,WebSiteetProfessionalService. - 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 (
<Section>,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: alwayssurmain[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é enprefers-reduced-motion, sous 620 px de haut, et dès qu'une région dépasse l'écran (html[data-snap="off"], posé paruseScrollReveal) pour ne jamais bloquer son contenu.app/hooks/useScrollReveal.tsobserve 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-delaypour le décalage, le hero est à 0,2 s). Quitter la région avant la fin annule le minuteur.app/globals.cssdéfinit.reveal-init/.is-revealed(fade-in-up).- Le contenu reste visible sans JavaScript ;
prefers-reduced-motiondé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 parThemeContext, persisté souscohaise-theme. - Langue :
LanguageContext, français au premier rendu, préférence persistée souscohaise-langpuis appliquée après hydratation.
Structure
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.