Communitygithub.com

brainzcode/premium-landing

Construye un menú de navegación móvil premium con un botón hamburguesa que se transforma en una X de cierre, panel de superposición a pantalla completa con revelación escalonada de enlaces, bloqueo de scroll, trampa de foco y manejo de movimiento reducido.

¿Qué es premium-landing?

Esta habilidad proporciona una implementación completa y robusta de un menú de navegación móvil premium, diseñada para evitar los fallos comunes que sufren muchos menús. Utiliza una única función `set(state)` que controla todos los aspectos del menú: la transformación del botón hamburguesa en una X, la apertura y cierre del panel superpuesto a pantalla completa, el bloqueo del scroll de la página, y la gestión del foco del teclado. La habilidad es compatible con cualquier proyecto web que utilice HTML, CSS y JavaScript vanilla, y está optimizada para funcionar correctamente en iOS, Android y navegadores de escritorio. Incluye manejo de movimiento reducido, trampa de foco para accesibilidad, y una serie de trampas o problemas comunes (como el z-index que se traga el botón de cierre, el efecto de rebote de iOS, o la imposibilidad de animar `display: none`) que la habilidad resuelve de forma específica. El resultado es un menú que se percibe como premium gracias a la cuidadosa elección de tiempos de transición, easing, tipografía y detalles visuales como números de índice escalonados y áreas táctiles de tamaño completo.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/premium-mobile-menu

Preguntar en tu IA favorita

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

Documentación

Menú móvil premium

Un menú móvil son cuatro cosas conectadas a un solo booleano: un botón que se transforma, un panel que se revela, la página detrás que se mantiene quieta, y el foco contenido en su interior. Casi todos los menús rotos lo están porque esas cuatro cosas se desincronizan — una de ellas se activa en otro lugar, por otra cosa.

Maneja todo desde una única función set(state). Sin classList.toggle() disperso por los manejadores de clic, sin una ruta de "cerrar" separada que olvide el bloqueo de scroll. Una función, todos los atributos, ambas direcciones.

Estructura

El encabezado tiene prioridad sobre el panel, y el panel lo cubre todo lo demás:

.nav  { position: fixed; inset: 0 0 auto; z-index: 210 }  /* la hamburguesa vive aquí */
.menu { position: fixed; inset: 0 0 auto; z-index: 200; height: 100dvh }
<header class="nav">
  <a class="brand" href="/">silva</a>
  <button class="burger" id="menuBtn" type="button"
          aria-label="Abrir menú" aria-expanded="false" aria-controls="menu">
    <i></i><i></i>
  </button>
</header>

<div class="menu" id="menu" role="dialog" aria-label="Menú" tabindex="-1" inert>
  <nav class="menu__nav">
    <a href="#about"><span class="menu__idx">01</span> Acerca de</a>
    <a href="#work"><span class="menu__idx">02</span> Trabajo</a>
  </nav>
  <div class="menu__foot">…</div>
</div>

La hamburguesa permanece en el encabezado y se transforma en su lugar. Es el control de apertura y el control de cierre, por lo que el encabezado debe estar por encima del panel — ver Trampa 1.

El botón

Objetivo de 44×44, barra visible de 22px. Las barras están posicionadas de forma absoluta y centradas con márgenes, no con transformaciones, para que la propiedad transform quede libre para la transformación:

.burger {
  position: relative; display: grid; place-items: center;
  width: 44px; height: 44px;
  background: none; border: 0; padding: 0; cursor: pointer;
  color: currentColor;
  -webkit-tap-highlight-color: transparent;
}

.burger i {
  position: absolute; left: 50%; top: 50%;
  margin: -.75px 0 0 -11px;          /* el centrado está aquí, no en transform */
  width: 22px; height: 1.5px;
  background: currentColor; border-radius: 2px;
  transition: transform .45s var(--ease);
}

.burger i:first-child { transform: translateY(-4px) }
.burger i:last-child  { transform: translateY(4px)  }

html.is-menu-open .burger i:first-child { transform: rotate(45deg)  }
html.is-menu-open .burger i:last-child  { transform: rotate(-45deg) }

Ambas barras comparten un mismo punto central, por lo que rotarlas ±45° produce una X simétrica sin necesidad de un segundo fotograma clave ni nada que ajustar. Si centras con translate(-50%,-50%) en su lugar, cada estado de transformación tiene que re-declarar ese translate y las dos barras se separan un píxel.

Usa dos barras, no tres. La X de tres barras necesita que la del medio se desvanezca mientras las dos exteriores convergen, y el desvanecimiento se ve como una mancha gris a mitad de la transición. Dos barras se transforman limpiamente. Si un estado de reposo de tres barras es innegociable, anima las barras exteriores con translateY + rotate y dale a la del medio una duración de opacity más corta para que desaparezca antes de que comience la rotación.

Nunca animes top/margin para mover las barras. Solo transform.

El panel

.menu {
  position: fixed; left: 0; right: 0; top: 0;
  height: 100dvh;                      /* no inset:0 — ver Trampa 2 */
  z-index: 200;
  display: flex; flex-direction: column; justify-content: space-between;
  padding: clamp(96px, 24vw, 150px) var(--gutter)
           max(clamp(28px, 7vw, 52px), env(safe-area-inset-bottom));
  background: var(--black); color: var(--white);
  overflow-y: auto; overscroll-behavior: contain;

  opacity: 0; visibility: hidden; transform: translateY(-12px);
  transition: opacity .45s var(--ease),
              transform .55s var(--ease),
              visibility 0s linear .45s;   /* ocultar solo después de que termine el desvanecimiento */
}

.menu.is-open {
  opacity: 1; visibility: visible; transform: none;
  transition-delay: 0s;                    /* cancelar el retardo de visibilidad en la entrada */
}

visibility es lo que hace que esto sea seguro para el teclado: elimina el panel cerrado del orden de tabulación, algo que opacity: 0 por sí solo no hace. La transición de visibility con retardo es todo el truco: visible inmediatamente al abrir, oculto solo después de que se haya reproducido el desvanecimiento.

La revelación escalonada de enlaces es lo que se percibe como costoso:

.menu__nav a {
  opacity: 0; transform: translateY(18px);
  transition: opacity .6s var(--ease), transform .6s var(--ease);
}
.menu.is-open .menu__nav a { opacity: 1; transform: none }

.menu.is-open .menu__nav a:nth-child(1) { transition-delay: .10s }
.menu.is-open .menu__nav a:nth-child(2) { transition-delay: .16s }
.menu.is-open .menu__nav a:nth-child(3) { transition-delay: .22s }
.menu.is-open .menu__nav a:nth-child(4) { transition-delay: .28s }
.menu.is-open .menu__nav a:nth-child(5) { transition-delay: .34s }

Separados por 60ms. Por debajo de ~40ms se percibe como un bloque; por encima de ~90ms el último elemento parece llegar tarde. Para una lista de longitud desconocida, pon style="--i:3" en cada elemento y usa transition-delay: calc(.10s + var(--i) * .06s).

A la salida, elimina los retardos (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Una salida escalonada hace que el cierre se sienta lento: el cierre debe ser inmediato.

La función de estado

(function () {
  var btn   = document.getElementById('menuBtn');
  var panel = document.getElementById('menu');
  var root  = document.documentElement;
  var open  = false;
  var scrollY = 0;

  var FOCUSABLE = 'a[href], button:not([disabled]), input, select, textarea,' +
                  '[tabindex]:not([tabindex="-1"])';

  // la hamburguesa es el control de cierre y vive fuera del panel, así que pertenece al ciclo
  function focusables() {
    return [btn].concat([].slice.call(panel.querySelectorAll(FOCUSABLE)));
  }

  function set(state) {
    if (state === open) return;
    open = state;

    panel.classList.toggle('is-open', open);
    root.classList.toggle('is-menu-open', open);
    btn.setAttribute('aria-expanded', String(open));
    btn.setAttribute('aria-label', open ? 'Cerrar menú' : 'Abrir menú');
    if (open) panel.removeAttribute('inert');
    else      panel.setAttribute('inert', '');

    if (open) {
      scrollY = window.scrollY;
      document.body.style.position = 'fixed';
      document.body.style.top = -scrollY + 'px';
      document.body.style.left = '0';
      document.body.style.right = '0';
      panel.focus({ preventScroll: true });
    } else {
      document.body.style.position = '';
      document.body.style.top = '';
      document.body.style.left = '';
      document.body.style.right = '';
      window.scrollTo(0, scrollY);
      btn.focus({ preventScroll: true });
    }
  }

  btn.addEventListener('click', function () { set(!open); });

  panel.querySelectorAll('a').forEach(function (a) {
    a.addEventListener('click', function () { set(false); });
  });

  document.addEventListener('keydown', function (e) {
    if (!open) return;
    if (e.key === 'Escape') { set(false); return; }
    if (e.key !== 'Tab') return;

    var list  = focusables();
    var first = list[0];
    var last  = list[list.length - 1];
    if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
    else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
  });

  // cruzar el punto de interrupción no debe dejar la página en un estado bloqueado
  matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
    if (e.matches) set(false);
  });
})();

inert reemplaza a aria-hidden aquí. Nunca pongas aria-hidden="true" en un panel que pueda contener el foco — si el foco está dentro, has ocultado el elemento enfocado del árbol de accesibilidad, lo que es un error de autoría que los lectores de pantalla manejan mal. inert bloquea el foco y oculta del árbol en un solo atributo.

Observa el role="dialog" sin aria-modal="true". aria-modal le dice a la tecnología de asistencia que ignore todo lo que está fuera del diálogo, y el botón de cierre está fuera de él. O bien omite aria-modal (como se muestra arriba) o coloca un botón de cierre real dentro del panel.

Trampa 1: el encabezado debe tener prioridad sobre el panel

La hamburguesa se transforma en la X, por lo que debe permanecer cliqueable mientras el panel está abierto. Si el z-index del panel es mayor que el del encabezado, la X se renderiza (está pintada en el encabezado) pero cada clic cae en la superposición. El menú se convierte en una trampa sin salida visible — reportado como "el botón de cierre no funciona".

Dale al encabezado un z-index mayor que el del panel y verifica ambos contra cualquier otra capa fija en la página (las barras de cookies y los CTA pegajosos son las colisiones habituales). Un conjunto funcional: panel 200, encabezado 210, toasts 9000.

Los elementos fijos solo se apilan entre sí cuando comparten un contexto de apilamiento. Un transform, filter, opacity < 1, o will-change en cualquier ancestro crea uno nuevo y silenciosamente re-padrea toda la comparación.

Trampa 2: overflow: hidden en el body no funciona en iOS

document.body.style.overflow = 'hidden' bloquea los navegadores de escritorio y no hace nada contra un arrastre táctil en iOS Safari. La página rebota detrás del panel y, al soltar, el usuario está en otro lugar por completo.

El bloqueo que funciona es fijar el body y restaurar el desplazamiento, que es lo que hace set() arriba. Dos detalles que lo acompañan:

  • overscroll-behavior: contain en el panel evita que el propio scroll del panel se encadene a la página cuando llega a un extremo.
  • Restaura con window.scrollTo(0, scrollY) en la misma llamada que limpia position. Leer scrollY después de que el body se ha desanclado da 0.

Si tu encabezado es position: sticky en lugar de fixed, este bloqueo lo rompe. Un body fijado no tiene puerto de scroll, por lo que sticky se resuelve contra el documento y el encabezado salta a la parte superior de la página — fuera de la pantalla, llevándose la hamburguesa consigo. Cámbialo a fixed mientras el menú esté abierto (html.is-menu-open .nav { position: fixed; top: 0 }). La habilidad lenis-smooth-scroll cubre el mismo fallo desde el lado de Lenis; si esa biblioteca está en la página, usa lenis.stop() en lugar de un segundo bloqueo en lugar de apilar ambos.

Prueba el bloqueo en un desplazamiento de scroll distinto de cero. En scroll 0, un bloqueo roto es idéntico píxel a píxel a uno que funciona. Desplázate a ~1200, abre, arrastra, cierra: la posición debe ser 1200 en todo momento.

Trampa 3: display: none no se puede transicionar

Alternar display salta la animación por completo: el panel aparece y desaparece de golpe. El patrón de visibility con transición retardada anterior es la versión que funciona en todas partes.

El equivalente moderno, si estás dispuesto a requerir una línea base de 2024+:

.menu { display: none; opacity: 0;
        transition: opacity .45s var(--ease), display .45s allow-discrete }
.menu.is-open { display: flex; opacity: 1 }
@starting-style { .menu.is-open { opacity: 0 } }

@starting-style es necesario — sin él la entrada no tiene valor inicial y solo la salida se anima.

Trampa 4: el panel es el lugar equivocado para un desenfoque de fondo

backdrop-filter en un panel a pantalla completa vuelve a muestrear todo lo que hay detrás cada fotograma, y en Android de gama media reduce la animación de entrada a fps de un solo dígito. En una compilación, eliminar una mezcla/desenfoque de viewport completo redujo los fotogramas perdidos del 34% al 3%.

Un menú premium es casi siempre un panel opaco de color de marca, no vidrio esmerilado. Si el diseño requiere vidrio, desenfoca un elemento pequeño (una hoja que cubre parte de la pantalla), nunca el viewport completo, y consulta la habilidad liquid-glass.

Trampa 5: los estados que nadie prueba

  • Redimensionar más allá del punto de interrupción mientras está abierto. Manejado arriba con matchMedia, no un listener de resize, por lo que se dispara una vez al cruzar en lugar de en cada fotograma de un arrastre.
  • Cambio de ruta del lado del cliente. En navegación Next/Astro/SPA, el panel sobrevive a la navegación. Llama a set(false) en el evento del enrutador y limpia los estilos del body al desmontar.
  • Botón de retroceso después de abrir. Si insertas una entrada de historial cuando se abre el menú, el botón de retroceso debe cerrarlo en lugar de salir de la página.
  • Zoom al 200%. El panel debe desplazarse en lugar de recortar su pie de página.
  • Teléfono en horizontal. 100dvh con un panel desplazable lo maneja; una lista centrada verticalmente con justify-content: center no.

Movimiento reducido

@media (prefers-reduced-motion: reduce) {
  .menu, .menu__nav a, .burger i {
    transition-duration: .01ms !important;
    transition-delay: 0s !important;
  }
}

Mantén los cambios de estado, elimina la coreografía. El panel debe seguir apareciendo y desapareciendo.

Qué lo hace percibir como premium

Los mecanismos anteriores son lo básico. Estas son las elecciones que lo diferencian de un cajón de bootstrap:

  • Easing. cubic-bezier(.16, 1, .3, 1) (expo-out) en el panel y los enlaces. Salida rápida, asentamiento largo. Nunca ease o linear.
  • Tiempo. Panel 450–600ms, enlaces 600ms con un escalonado de 60ms, transformación de la hamburguesa 450ms. Por debajo de 300ms nada se registra como movimiento; por encima de 700ms se siente lento.
  • Tipografía. La lista de enlaces es el diseño. clamp(1.65rem, 8.4vw, 2.9rem), peso de visualización 300, line-height: 1, mayúsculas, tracking ajustado. Reglas finas entre filas.
  • Numeración de índice. 01 / 02 / 03 en mono pequeño o mayúsculas con espaciado antes de cada etiqueta, en un tono apagado. Barato de añadir, hace más por la calidad percibida que cualquier efecto.
  • Áreas táctiles de fila completa. Relleno vertical de clamp(14px, 3.4vw, 22px) en el propio ancla, no un margen a su alrededor, para que toda la fila sea táctil.
  • Un estado :active, no un estado :hover. Los teléfonos no hacen hover, y un estilo hover que persiste después de un toque se ve roto.
  • Un bloque de pie de página — línea de contacto, redes sociales, un único CTA tipo píldora — fijado con justify-content: space-between. El espacio vacío inferior es lo que hace que un menú parezca un marcador de posición.
  • Sin rebote o resorte en el panel mismo. Sobrepasar en una superficie a pantalla completa se percibe como barato. Reserva el easing de resorte para elementos pequeños.

Lista de verificación

  • Una única función set(state) posee la clase, aria-expanded, la etiqueta, inert, y el bloqueo de scroll
  • El z-index del encabezado está por encima del del panel, verificado contra cualquier otro elemento fijo
  • El bloqueo de scroll se ha probado en iOS con scroll > 0
  • overscroll-behavior: contain en el panel
  • inert en el panel cerrado, no aria-hidden
  • aria-modal no está presente en el panel del diálogo
  • El menú se cierra con Escape
  • El foco de tabulación se cicla dentro del panel
  • event.preventDefault() se llama en los límites de la lista de elementos enfocables
  • La hamburguesa está incluida como primer/último elemento enfocable
  • No hay display: none en el panel
  • visibility: hidden se usa con un retardo en la transición de salida
  • Los enlaces tienen una transición de retardo en la entrada, y sin retardo en la salida
  • @starting-style o el patrón de visibilidad se usa para animar la entrada
  • El menú se cierra al cambiar de ruta
  • El menú se cierra al redimensionar más allá del punto de interrupción
  • prefers-reduced-motion: reduce establece duraciones de transición a ~0ms
  • El botón hamburguesa se centra con márgenes, no con transformaciones
  • Dos barras <i>, no tres
  • aria-label cambia entre "Abrir menú" / "Cerrar menú"
  • aria-expanded se actualiza correctamente
  • No se usan top, margin, ni desplazamientos de píxeles para animar las barras hamburguesa
  • Se elimina inert cuando el panel está abierto

Individual skills in this repo

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

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Skills relacionados