Communitygithub.com

Mobile-first 3D

Expérience dédiée aux téléphones/tablettes pour les sites 3D/WebGL lourds — détection du profil d’appareil, paramètres de rendu et jeux de textures allégés, cadrage portrait pour que les sujets (planètes avec anneaux, galaxies) ne soient jamais coupés, feuille de contenu en bas, menu en feuille, zones de sécurité, comportement tactile et défilement plus court. À utiliser systématiquement lors de la construction d’un site 3D, et chaque fois que quelqu’un dit « sur mobile c’est coupé / pas bien visible / lent / moche ».

Qu'est-ce que Mobile-first 3D ?

Cette compétence permet d’adapter un site WebGL lourd aux écrans mobiles en créant un profil séparé, activé par la classe `html.mobile`. Elle détecte automatiquement les appareils tactiles via le pointeur grossier ou la taille d’écran inférieure à 600 px, avec possibilité de forcer le mode via `?m=1` ou `?m=0` pour les tests en émulation. Le rendu est allégé (DPR réduit, géodésiques simplifiées, volumes d’échantillonnage diminués, jeux de textures compressés) et le parallax à la souris est désactivé. Le cadrage portrait corrige le problème de découpage des sujets : la distance à la caméra est calculée en tenant compte des anneaux (Saturne, Uranus), la vue est inclinée vers le bas d’environ 0,21 rad pour placer le sujet dans le tiers supérieur, et l’éclairage est plus frontal pour éviter les zones d’ombre qui semblent « coupées » sur petit écran. La mise en page utilise une feuille de contenu en bas (bottom sheet) avec hauteur maximale de 60 vh, un menu burger pleine page, des titres adaptatifs, un défilement plus court et des zones de sécurité pour les encoches et barres de navigation. La compétence propose une matrice de test minimale (375×812, 390×844, 412×915, 768×1024) et recommande un test sur appareil réel.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/mobile-first-3d

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Mobile-first 3D ?

Les téléphones ne sont pas des petits écrans de bureau. Construisez un profil séparé, activé par une seule classe : html.mobile.

1. Détection

const MOBILE = qs.get('m') === '1' || (qs.get('m') !== '0' &&
  (matchMedia('(pointer: coarse)').matches || Math.min(innerWidth, innerHeight) < 600));
document.documentElement.classList.toggle('mobile', MOBILE);

?m=1 / ?m=0 force le mode — essentiel pour les tests en émulation de bureau.

2. Profil de rendu

RéglageBureauTéléphone
Limite DPR / pixels max1,5 / 3,2 MP1,25 / 1,0 MP
Pas géodésiques220150
Échantillons de volume3624
Taille du bake de ciel768 / 512384 / 256
Jeu de texturestextures/hd (~6 Mo)textures/m (~1,2 Mo)
Parallax / regard autour avec la sourisactivédésactivé (tactile uniquement ; les émulateurs envoient des événements souris)

3. Cadrage portrait (d’où viennent la plupart des bugs « c’est coupé »)

  • Le champ horizontal (FOV) en portrait est minuscule : tan(hFOV/2) = tan(vFOV/2)·aspect (≈0,22 à 52° et 0,46 d’aspect).
  • Distance de chaque sujet = max(R·distMul·1,25, visibleRadius·7,6) ; visibleRadius inclut les anneaux (Saturne ≈ 2,35 R, Uranus ≈ 1,8 R).
  • Visez sur le sujet, puis inclinez toute la vue vers le bas d’environ 0,21 rad pour qu’il se trouve dans le tiers supérieur, au-dessus de la feuille de texte. (Décaler la cible à la place fait dériver latéralement lorsque la caméra se déplace.)
  • Éclairage plus frontal (phase ~45°) : les planètes éclairées de côté et à moitié noires sont lues comme « coupées » sur les petits écrans.
  • Verrouillez la visée pendant les maintiens de contenu (tangentes cibles nulles) — pas de dérive centrifuge.
  • Vérifiez numériquement : affichez une image, readPixels les lignes traversant le sujet, vérifiez que l’étendue éclairée se trouve entre 5 et 95 % de la largeur.

4. Mise en page

  • Les panneaux → feuille de contenu en bas : left:0; right:0; bottom:0; max-height:60vh; overflow:auto, arrière-plan en dégradé, padding-bottom: calc(54px + env(safe-area-inset-bottom)).
  • Titres clamp(34px, 10vw, 52px) ; nom du héros réparti sur 2 lignes.
  • Navigation → burger + feuille floue plein écran avec des liens de 44 px en police serif.
  • Cachez les rails décoratifs ; raccourcissez les étiquettes (nom uniquement) ; cachez l’indice de défilement d’atterrissage s’il entre en collision.
  • Défilement plus court : intro ~320 vh, voyage ~2600 vh (les téléphones défilent plus vite grâce à l’inertie).
  • viewport-fit=cover, étapes collées 100svh, pas de débordement horizontal à 320 px.

5. Matrice de test (l’émulation ne suffit pas, mais c’est le minimum)

375×812 et 390×844 portrait, 412×915 Android, 768×1024 tablette. Chaque étape de contenu : sujet entièrement visible et centré au-dessus de la feuille, texte lisible, rien sous l’encoche ni la barre d’accueil. Indiquez honnêtement à l’utilisateur lorsqu’un test sur appareil réel n’a pas été effectué.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés