Communitygithub.com

Mobile-First 3D

Spezielle Handy/Tablet-Erfahrung für schwere 3D/WebGL-Seiten – Geräteprofil-Erkennung, leichtere Render-Einstellungen und Textur-Sets, Porträt-Kamera-Rahmung, damit Objekte (Planeten mit Ringen, Galaxien) nie abgeschnitten werden, Bottom-Sheet-Inhalt, Menü-Sheet, Safe-Areas, Touch-Verhalten und kürzeres Scrollen. Immer verwenden, wenn eine 3D-Seite gebaut wird, und immer dann, wenn jemand sagt „auf dem Handy wird es abgeschnitten / nicht richtig gesehen / ist es langsam / sieht es hässlich aus“.

Was ist Mobile-First 3D?

Das Skill `mobile-first-3d` bietet eine dedizierte mobile Benutzererfahrung für schwere 3D- und WebGL-Websites. Es erkennt automatisch mobile Geräte anhand der Zeigergenauigkeit und Bildschirmgröße (mit Zwangsmöglichkeit via `?m=1`/`?m=0` für Tests) und wendet ein optimiertes Render-Profil mit reduzierter DPR, Texturgröße und geometrischer Komplexität an, um Leistungsprobleme zu vermeiden. Im Mittelpunkt steht die Porträt-Kamera-Rahmung: sie berechnet den korrekten Abstand und die Neigung, damit Objekte wie Planeten mit Ringen oder Galaxien nicht abgeschnitten werden – eine häufige Fehlerquelle auf mobilen Geräten. Das Skill definiert außerdem ein mobiles Layout mit Bottom-Sheets, einem Burger-Menü, verkürztem Scrollen und berücksichtigt Safe-Areas sowie Touch-Interaktionen. Es ist plattformunabhängig (funktioniert mit jedem WebGL-Framework) und enthält eine Testmatrix für gängige Mobilgeräte (375×812, 390×844, 412×915, 768×1024), um die Sichtbarkeit aller Inhalte zu garantieren.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Mobile-First 3D?

Handys sind keine kleinen Desktops. Baue ein separates Profil, umgeschaltet durch eine Klasse: html.mobile.

1. Erkennung

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 erzwingen es – essenziell zum Testen in der Desktop-Emulation.

2. Render-Profil

EinstellungDesktopTelefon
DPR-Obergrenze / max. Pixel1.5 / 3.2 MP1.25 / 1.0 MP
Geodätische Schritte220150
Volumensamples3624
Himmels-Bake-Größe768 / 512384 / 256
Textur-Settextures/hd (~6 MB)textures/m (~1.2 MB)
Maus-Parallaxe / Herumblickenanaus (nur Touch; Emulatoren senden Mausereignisse)

3. Porträt-Rahmung (woher die meisten „es ist abgeschnitten“-Fehler kommen)

  • Das horizontale Sichtfeld im Hochformat ist winzig: tan(hFOV/2) = tan(vFOV/2)·aspect (≈0,22 bei 52° und 0,46 Seitenverhältnis).
  • Abstand zu jedem Objekt = max(R·distMul·1,25, visibleRadius·7,6); visibleRadius umfasst Ringe (Saturn ≈ 2,35 R, Uranus ≈ 1,8 R).
  • Auf das Objekt zielen, dann die gesamte Ansicht um ≈ 0,21 rad nach unten neigen, damit es im oberen Drittel über dem Textsheet sitzt. (Die Verschiebung des Ziels stattdessen führt bei Kamerabewegung zu seitlichem Abdriften.)
  • Mehr frontale Beleuchtung (~45° Phase): seitlich beleuchtete halbschwarze Planeten wirken auf kleinen Bildschirmen „abgeschnitten".
  • Das Ziel während Inhalts-Holds (Null-Target-Tangenten) fixieren – kein Abdriften aus der Mitte.
  • Numerisch überprüfen: einen Frame rendern, readPixels Zeilen über das Objekt, prüfen, ob der beleuchtete Bereich innerhalb von 5–95 % der Breite liegt.

4. Layout

  • Panels → Bottom-Sheet: left:0; right:0; bottom:0; max-height:60vh; overflow:auto, Verlaufs-Hintergrund, padding-bottom: calc(54px + env(safe-area-inset-bottom)).
  • Titel clamp(34px, 10vw, 52px); Heldenname auf 2 Zeilen aufgeteilt.
  • Navigation → Burger + Vollbild-Unschärfesheet mit 44 px Serifen-Links.
  • Dekorative Schienen ausblenden; Labels kürzen (nur Name); den Lande-Scrollhinweis ausblenden, wenn er kollidiert.
  • Kürzeres Scrollen: Einführung ~320vh, Reise ~2600vh (Handys scrollen durch Momentum schneller).
  • viewport-fit=cover, 100svh fixe Abschnitte, kein horizontaler Überlauf bei 320 px.

5. Testmatrix (Emulation reicht nicht, ist aber das Minimum)

375×812 und 390×844 Hochformat, 412×915 Android, 768×1024 Tablet. Jeder Inhaltsbeat: Objekt vollständig sichtbar und oberhalb des Sheets zentriert, Text lesbar, nichts unter der Notch/Home-Leiste. Den Nutzer ehrlich informieren, wenn kein Test auf einem echten Gerät durchgeführt wurde.

Individual skills in this repo

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

Verwandte Skills