lkdv-ios27-page-refonte
Use when redesigning, migrating, or auditing any LKDV application page (clubs, carnets, groupes, evenements, explorer, materiel, messagerie) to match the consolidated Oct 24 2026 Compte + Communauté v
SKILL.md.claude/skills/lkdv-ios27-page-refonte/SKILL.md
GitHubLKDV iOS 27 Liquid Glass (Oct 24 Consolidated) — Skill de Refonte & Adaptation Métier
Guide technique et architectural de référence pour décliner la grammaire mesurée de /compte (v20 modulaire) et /communaute (v3 « Pour toi » + PostGlassPanel) sur les pages de l'application (/clubs, /clubs/[id], /carnets, /groupes, /evenements, etc.).
Principe Directeur : On conserve 100 % de la forme, de la géométrie et des tokens mesurés des éléments de
/compteet/communaute, mais on adapte intelligemment le contenu et la disposition métier à chaque page. La scène principale est strictement interdite au scroll global (100dvh,overflow: hidden) : l'écran principal reste ultra-simple et épuré, et toute la richesse fonctionnelle est distribuée dans les drawers en place dans la carte (DrawerShell/SlotShell), les sous-drawers (.lkdv-drawer-secondary30px) et les panneaux de post superposés (PostGlassPanel).
1. Invariants Absolus (Règles non négociables)
- Zéro modification dans
/compas:src/app/compas/**etsrc/features/compas/**ne doivent jamais être modifiés ni importer de code des refontes. - Zéro scroll de page principale (
100dvhverrouillé) :- Le châssis principal (
.phone) occupe100dvhavecoverflow: hiddenet un split Carte Haute (60%) / Carte 3D MapLibre Basse (40%) (et mode.mapbig172px / 1fr). - Seul l'intérieur de la carte (
.card-scroll), du volet actif d'un drawer (.lkdv-drawer-pane.active) ou du corps d'un panneau de post (.lkdv-post-panel-body) peut scroller (overscroll-behavior: contain).
- Le châssis principal (
- Une seule barre de navigation basse (
.tb402 × 48px) :- La route doit être déclarée dans
HIDE_CHROME_PREFIXESdesrc/components/mobile-nav/MobileNavWrapper.tsxpour éviter toute double barre de navigation.
- La route doit être déclarée dans
- Le Drawer EST la Carte (aucun modal plein écran, aucun voile sombre, aucun titre, aucune croix) :
- Ouvrir un drawer remplace le contenu de la carte hôte (
406 × n,border-radius: 24px, calé viasyncCardBounds()). - Il ajoute uniquement une poignée
.grab(18px, barre40 × 4px), une capsule haute.lkdv-capsule(378 × 48px, icônes seules) et, si nécessaire, une sous-capsule flottante.ig-tabs-float(30px, bas-droite, icônes seules). - Fermeture par : clic/swipe sur la poignée
.grab, re-clic sur l'onglet actif, toucheÉchap, ou clic sur la carte 3D.
- Ouvrir un drawer remplace le contenu de la carte hôte (
- Sélecteurs 100 % Icônes Seules :
- Aussi bien dans la capsule haute
48px(.lkdv-capsule/.segc.lg-tabs) que dans la sous-capsule flottante30px(.ig-tabs-float .ig-tabs) et la barre basse.tb48px: icônes SVG pures (18–19px) uniquement, aucun libellé texte visible.role="tablist",role="tab",aria-labeletaria-selectedsont obligatoires.
- Aussi bien dans la capsule haute
- Système de Post Partagé (
PostGlassPanel+post-system.css) :- Quand une carte intègre un fil d'actualité (comme sur Communauté ou Club), chaque post utilise
.lkdv-feed-post(carré1:1média ou.lkdv-feed-post--textverre Compte). - Les commentaires et le partage ne s'ouvrent jamais dans une feuille plein écran : ils s'ouvrent en panneau verre superposé au post (
.lkdv-post-panel-slot) démarrant8pxsous le header du post (--post-panel-top: 64px), laissant toujours la pastille auteur.pmi-authoret le bouton···visibles et cliquables. - Swipe horizontal sur le post = bascule Commentaires ↔ Partage ; swipe bas = ferme le panneau.
- Quand une carte intègre un fil d'actualité (comme sur Communauté ou Club), chaque post utilise
- Matériau Liquid Glass Clair exclusif & Palette Forest :
- Aucun mode sombre, jamais de
rgba(0,0,0)brut, jamais d'orange#E4501C, jamais d'aplat vert plein#17402Csur les boutons d'onglets des drawers (utiliser--pget la lentille verre).
- Aucun mode sombre, jamais de
- Sécurité & Vérité des données :
- Profils publics chargés en 2 étapes via
fetchPublicProfilesWith(supabase, userIds)(@/lib/queries/publicProfilesCore). - Échappement XSS systématique (
esc()) dans tout HTML runtime. - Compteurs réels (requêtes
countou lignes réelles, jamais de métriques inventées).
- Profils publics chargés en 2 étapes via
2. Tokens Mesurés (Source de Vérité 430 × 932)
Aucune valeur hors de ces tokens mesurés sur /compte et /communaute ne doit être inventée :
| Élément / Token | Valeur Mesurée | Origine (13-comparatif-compte-communaute.md) |
|---|---|---|
| Largeur colonne / Gouttière | Viewport 430px, gouttière 12px |
Carte Compte à x = 12 sur 430 |
Carte principale (.card.cs) |
Largeur 406px (430 - 2×12), border-radius: 24px, padding 14px |
.card.cs sur /compte |
| Verre de carte & panneau | linear-gradient(180deg, rgba(255,255,255,.486), rgba(255,255,255,.384)) + blur(25.2px) saturate(1.8) brightness(1.05) |
.card.cs & post-system.css |
| Ombre de carte | inset 0 1px 0 rgba(255,255,255,.95), inset 0 -1px 1px rgba(255,255,255,.4), 0 0 0 .5px rgba(23,43,36,.10), 0 8px 22px rgba(23,43,36,.10) |
.card.cs |
Top Bar (.head) |
Hauteur 56px (8 + 40 + 8), pilule identité/contexte 40px + boutons ronds .gbtn 38 × 38px (r=50%) |
/compte & /communaute |
| Avatar / Blason / Cover | 66 × 66px (r=50% profil ou r=18px blason club / couverture carnet) |
.ig-avi-wrap |
Cellules Statistiques (.ig-stat) |
3 boutons cliquables 101 × 39px, border-radius: 14px |
Ouvrent chacune un drawer ou volet dédié |
| Typo Statistique | Valeur : 19px / 700 (letter-spacing: -0.38px) · Libellé : 10.5px / 500, #56665d, sans majuscules |
.num & label Compte |
| Titre dans la carte | 19px / 700 (plafond typographique strict de la carte) |
.card.cs |
| Bio / Description | 12px / 1.3, couleur #56665d |
.ig-bio-text |
Actions rapides / Cercles (.ig-hl) |
Bloc 72 × 56px : cercle 44 × 44px + libellé 9px / 500 dessous |
Highlights / Actions rapides Compte |
| Enveloppe Flux / Grille dans carte | border-radius: 22px (.ig-grid-wrap ou conteneur de flux interne) |
Dans .card.cs |
Post inline (.lkdv-feed-post) |
Carré 1:1 (média) ou auto plafonné (.lkdv-feed-post--text), r=22px (en carte) ou 28px (en fil), auteur .pmi-author (avatar 28px, nom 12/600, meta 10.5), bouton ··· 34×34, capsule actions 116 × 40px (boutons 34×34 r=50%) |
CommunityFeedPost.tsx & post-system.css |
Panneau Post (PostGlassPanel) |
.lkdv-post-panel-slot à top: 64px (8px sous le header du post), verre Compte, swipe G/D (Commentaires ↔ Partage), composer pilule 36px + envoi 34px en bas |
PostGlassPanel.tsx |
Poignée de Drawer (.grab) |
Zone 18px en haut de la carte-drawer, barre 40 × 4px, rgba(23,43,36,.35) |
#sheet .grab |
Capsule de Drawer (.lkdv-capsule) |
378 × 48px (406 - 2×14), lentille 74 × 40px (calc((100% - 6px)/var(--n))), icônes 18px seules, transition 420ms cubic-bezier(.32,.72,0,1) |
DrawerShell.tsx / SlotSelector.tsx |
Sous-capsule flottante (.ig-tabs-float) |
Hauteur 30px, largeur calc(var(--n)*44px + 5px), lentille 25px, right: 10px; bottom: 10px, icônes seules + zone tactile 44px (::after) |
DrawerShell.tsx & .ig-tabs-float |
Barre basse (.tb) |
402 × 48px à x = 14 (min(100% - 28px, 500px)), lentille 40px, icônes seules |
AccountBottomBar / .tb |
| Couleurs d'encre | Encre primaire #17402c / #172B24 · Muted #56665d · Like #e0245e · Fond #cfd6c8 (account-bg.webp) |
Socle partagé |
3. Architecture Type : Adapter la Forme Compte + Communauté à un Nouveau Métier (ex. Club)
Principe d'Adaptation (Même Forme, Disposition & Contenu Métier Adaptés)
Au lieu de copier-coller le contenu d'un profil personnel, chaque page recompose les briques canoniques de /compte et /communaute autour de son usage réel, tout en gardant zéro scroll sur la page principale :
┌──────────────────────────────────────────────────────────┐ Viewport 100dvh (overflow: hidden)
│ Dynamic Island (#island) + Status │
│ Top Bar 56px : [Pilule Sélecteur/Membre 40px] [🔍38][+38]│
│ ┌──────────────────────────────────────────────────────┐ │ Carte 406px, r=24, verre .cs (Zone 60%)
│ │ ┌──────┐ [ 101×39 ] [ 101×39 ] [ 101×39 ] │ │ Blason 66px (r18) + 3 cellules stats 19/700
│ │ │ 66px │ Membres Sorties Km / Défis │ │ Chaque stat ouvre directement son Drawer !
│ │ └──────┘ │ │
│ │ Nom du Club (19/700) · Massif · Badge vérifié │ │ Méta 11/10.5 muted + Bio 12/1.3 (2 lignes)
│ │ (⚡44) (🏕️44) (🎒44) (🏆44) (➕44) │ │ Cercles 44px + label 9px → ouvrent Drawers
│ │ ┌────────────────────────────────────────────────┐ │ │
│ │ │ FIL D'ACTU DU CLUB (remplace la grille 3×3 !) │ │ │ Scroll interne confiné dans la carte
│ │ │ ┌────────────────────────────────────────────┐ │ │ │ Cartes .lkdv-feed-post (1:1 ou texte verre)
│ │ │ │ (av28) @auteur · Spot · 2h ··· │ │ │ │ + PostGlassPanel (Commentaires ↔ Partage)
│ │ │ │ │ │ │ │ en swipe horizontal directement sur le post
│ │ │ │ ╭ ♥34 💬34 ➤34 ╮ │ │ │ │
│ │ │ └────────────────────────────────────────────┘ │ │ │
│ │ └────────────────────────────────────────────────┘ │ │
│ │ ╭ 📰 ⊞ 📅 ╮ │ │ Sous-sélecteur flottant 30px (.ig-tabs-float)
│ └──────────────────────────────────────────────────────┘ │ (ex: Fil d'actu / Grille Médias / Prochain RDV)
│ ┌──────────────────────────────────────────────────────┐ │
│ │ CARTE 3D MAPLIBRE VIVANTE (Zone 40% ou .mapbig) │ │ Traces GPX du club, camps de base, membres,
│ │ [Poignée .mgrab] [Callouts verre] [Contrôles .mctl]│ │ météo massif, synchronisation avec le fil
│ └──────────────────────────────────────────────────────┘ │
│ ╭────────── Barre basse .tb (402 × 48px) ──────────╮ │
└──────────────────────────────────────────────────────────┘
Anatomie de la Carte quand un Drawer est ouvert (DrawerShell en place)
Dès qu'on clique sur une cellule stat (101×39), un cercle d'action (44px), la pilule de la Top Bar ou un bouton de la barre basse :
- La carte garde exactement ses dimensions (
406 × n,r=24,syncCardBounds()), - Son contenu est remplacé par
DrawerShell:- En haut : Poignée
.grab(18px) + Capsule.lkdv-capsule(378 × 48px, icônes seules) permettant de basculer entre les grands volets du drawer (ex: Cordée & Membres, Sorties & Camps, Matériel Mutualisé, Défis & Trace, Gouvernance & Réglages). - Au centre : Piste horizontale
.lkdv-drawer-trackavec scroll interne confiné dans.lkdv-drawer-pane.active. - En bas à droite : Sous-capsule flottante
.ig-tabs-float.lkdv-drawer-secondary(30px, icônes seules) pour filtrer le volet actif (ex: dans Sorties :[À venir] [Passées] [Proposer]; dans Matériel :[Disponible] [Emprunté] [Demandes]; dans Membres :[Tous] [Guides/Encadrants] [Proches]).
- En haut : Poignée
4. Composants Partagés à Réutiliser (Ne jamais dupliquer)
- Drawers & Volets en place dans la carte :
src/components/compte/drawer/shell/DrawerShell.tsx(DrawerShell,DrawerSkeleton,DrawerError,DrawerEmpty,DRAWER_SHELL_CSS)src/components/compte/drawer/SlotShell.tsx&SlotSelector.tsx
- Système de Post & Panneau Commentaires/Partage en place :
src/features/posts/ui/PostGlassPanel.tsxsrc/features/posts/ui/post-system.csssrc/features/community/feed/CommunityFeedPost.tsx,PostCommentsPanel.tsx,PostSharePanel.tsx
- Carte 3D & Contexte Géospatial :
src/components/compte/map/CompteMap.tsx,CompteMapHud.tsx,CompteMapCallout.tsx,useCompteMapContext.ts
- Navigation & Chrome :
src/components/mobile-nav/MobileNavWrapper.tsx(masquer la nav globale si.tbest présent)
5. Workflow de Refonte & Vérification en 5 Étapes
- Audit & Design d'Adaptation :
- Identifier ce qui reste sur la carte principale (ultra-épuré, zéro scroll de page) et ce qui est réparti dans les Drawers (
48pxcapsule) et Sous-Drawers (30pxsous-capsule).
- Identifier ce qui reste sur la carte principale (ultra-épuré, zéro scroll de page) et ce qui est réparti dans les Drawers (
- Contrat de Tests (TDD) :
- Vérifier les tokens mesurés (
406px,r=24px,.gbtn38px,.ig-stat101×39, cercles44px, capsule378×48icônes seules, sous-capsule30px,PostGlassPaneltop: 64px,0scroll document,0diff dans/compas).
- Vérifier les tokens mesurés (
- Implémentation Modulaire :
- Construire les volets avec
DrawerShellet le flux avecPostGlassPanel+post-system.css.
- Construire les volets avec
- Vérification Visuelle Côte à Côte (Playwright 430 × 932) :
- Prendre systématiquement une capture
430 × 932de/compte,/communauteet de la page refondue (carte fermée, panneau post ouvert, drawer ouvert, sous-drawer actif, carte 3D déployée) et comparer les géométriesgetBoundingClientRect().
- Prendre systématiquement une capture
- Validation & Déploiement :
npx tsc --noEmit,npx vitest run,npm run build, push surmain.