Communitygithub.com

mobile-first-3d

Experiencia dedicada para teléfono/tableta en sitios 3D/WebGL pesados: detección de perfil de dispositivo, configuraciones de renderizado y texturas más ligeras, encuadre de cámara en retrato para que los sujetos (planetas con anillos, galaxias) nunca se recorten, hoja inferior, hoja de menú, áreas seguras, comportamiento táctil y scroll más corto. Úsalo siempre al construir un sitio 3D, y cuando alguien diga "en móvil se corta / no se ve bien / va lento / se ve feo".

¿Qué es mobile-first-3d?

Esta skill está diseñada para desarrolladores que crean sitios 3D/WebGL pesados y necesitan una experiencia óptima en dispositivos móviles (teléfonos y tabletas). Proporciona detección automática de perfil de dispositivo, configuraciones de renderizado más ligeras (como límite de DPR, pasos geodésicos, tamaño de texturas), encuadre de cámara en modo retrato para evitar que los sujetos se recorten (especialmente importante para planetas con anillos o galaxias), y un diseño de interfaz adaptado con hojas inferiores, menú de navegación y áreas seguras. Compatible con cualquier sitio 3D que use WebGL, Three.js, Babylon.js o similar. La detección se realiza mediante un simple fragmento de JavaScript que añade la clase `html.mobile`, y se puede forzar con parámetros de URL (`?m=1` o `?m=0`) para pruebas en emulación de escritorio. La skill también incluye pautas de prueba mínimas para emuladores y recomienda pruebas en dispositivos reales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Mobile-first 3D (Prioridad móvil en 3D)

Los teléfonos no son escritorios pequeños. Construye un perfil separado, activado por una clase: html.mobile.

1. Detección

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 lo fuerzan — esencial para pruebas en emulación de escritorio.

2. Perfil de renderizado

ConfiguraciónEscritorioTeléfono
Límite DPR / píxeles máx.1.5 / 3.2 MP1.25 / 1.0 MP
Pasos geodésicos220150
Muestras de volumen3624
Tamaño de cielo horneado768 / 512384 / 256
Conjunto de texturastextures/hd (~6 MB)textures/m (~1.2 MB)
Paralaje / mirada con ratónactivadodesactivado (solo táctil; los emuladores envían eventos de ratón)

3. Encuadre en retrato (de donde vienen la mayoría de errores de "se corta")

  • El FOV horizontal en retrato es pequeño: tan(hFOV/2) = tan(vFOV/2)·aspect (≈0.22 a 52° y relación de aspecto 0.46).
  • Distancia desde cada sujeto = max(R·distMul·1.25, visibleRadius·7.6); visibleRadius incluye anillos (Saturno ≈ 2.35 R, Urano ≈ 1.8 R).
  • Apunta al sujeto, luego inclina toda la vista hacia abajo ≈ 0.21 rad para que quede en el tercio superior, por encima de la hoja de texto. (Desplazar el objetivo en lugar de inclinar hace que se desvíe lateralmente cuando la cámara se mueve).
  • Ilumina más frontalmente (~45° de fase): los planetas medio negros iluminados lateralmente se leen como "recortados" en pantallas pequeñas.
  • Bloquea la mira durante las pausas de contenido (tangentes del objetivo a cero) — sin desviarse del centro.
  • Verifica numéricamente: renderiza un fotograma, readPixels filas a través del sujeto, comprueba que el tramo iluminado está dentro del 5–95 % del ancho.

4. Diseño

  • Paneles → hoja inferior: left:0; right:0; bottom:0; max-height:60vh; overflow:auto, fondo degradado, padding-bottom: calc(54px + env(safe-area-inset-bottom)).
  • Títulos clamp(34px, 10vw, 52px); nombre del héroe dividido en 2 líneas.
  • Navegación → hamburguesa + hoja desenfocada a pantalla completa con enlaces serif de 44 px.
  • Oculta rieles decorativos; acorta etiquetas (solo nombre); oculta la sugerencia de scroll de aterrizaje si choca.
  • Scroll más corto: intro ~320vh, viaje ~2600vh (los teléfonos hacen scroll más rápido con el impulso).
  • viewport-fit=cover, etapas fijas 100svh, sin desbordamiento horizontal a 320 px.

5. Matriz de pruebas (la emulación no es suficiente, pero es el mínimo)

375×812 y 390×844 en retrato, 412×915 Android, 768×1024 tableta. Cada momento de contenido: que el sujeto esté completamente visible y centrado sobre la hoja, que el texto sea legible, que nada quede debajo del notch o la barra de inicio. Indica honestamente al usuario cuando no se ha realizado una prueba en dispositivo real.

Individual skills in this repo

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

Skills relacionados