Communitygithub.com

brainzcode/premium-landing

Cria um menu móvel premium — um botão hamburger que se transforma em X de fechar, um painel de sobreposição em tela cheia com revelação escalonada de links, bloqueio de rolagem, armadilha de foco e suporte a movimento reduzido.

O que é premium-landing?

Esta skill implementa um menu de navegação móvel de alta qualidade, focado em desempenho e acessibilidade. Ela resolve os problemas comuns de menus quebrados — como o botão de fechar que não responde, a rolagem de fundo que continua mesmo com o menu aberto (especialmente no iOS), o vazamento de foco do teclado para a página subjacente e a perda de posição de rolagem. A abordagem central é usar uma única função `set(state)` que sincroniza todos os estados do menu (transformação do botão, visibilidade do painel, bloqueio de rolagem, foco e atributos de acessibilidade), evitando manipulações de classe espalhadas. Orienta sobre a estrutura HTML/CSS/JS correta, com dicas sobre z-index (armadilha 1), bloqueio de rolagem no iOS (armadilha 2), animações com `visibility` em vez de `display: none` (armadilha 3), e otimizações de desempenho para animações suaves. Suporta as plataformas web padrão (navegadores modernos) e pode ser integrada em projetos com React/Next/Astro, com tratamento para navegação por rota e redimensionamento de janela.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Menu móvel premium

Um menu móvel é composto por quatro elementos conectados a um único estado booleano: um botão que se transforma, um painel que se revela, a página atrás dele mantida parada e o foco mantido dentro. Quase todo menu quebrado está quebrado porque esses quatro elementos saíram de sincronia — um deles é alternado em outro lugar, por outra coisa.

Dirija tudo a partir de uma única função set(state). Sem classList.toggle() espalhado por manipuladores de clique, sem caminho "fechar" separado que esquece o bloqueio de rolagem. Uma função, cada atributo, ambas as direções.

Estrutura

O cabeçalho tem prioridade sobre o painel, e o painel cobre tudo o mais:

.nav  { position: fixed; inset: 0 0 auto; z-index: 210 }  /* burger vive aqui */
.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 menu" aria-expanded="false" aria-controls="menu">
    <i></i><i></i>
  </button>
</header>

<div class="menu" id="menu" role="dialog" aria-label="Menu" tabindex="-1" inert>
  <nav class="menu__nav">
    <a href="#about"><span class="menu__idx">01</span> Sobre</a>
    <a href="#work"><span class="menu__idx">02</span> Trabalho</a>
  </nav>
  <div class="menu__foot">...</div>
</div>

O burger permanece no cabeçalho e se transforma no lugar. Ele é o controle de abertura e o controle de fechamento, razão pela qual o cabeçalho precisa ficar acima do painel — veja a Armadilha 1.

O botão

Alvo de 44×44, 22px de barra visível. As barras são posicionadas absolutamente e centralizadas com margens, não com transformações, para que a propriedade transform permaneça livre para a transformação:

.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;          /* centralização está aqui, não no 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 as barras compartilham um ponto central, então girá-las em ±45° produz um X simétrico sem segundo keyframe e sem nada para ajustar. Se você centralizar com translate(-50%,-50%), cada estado de transformação tem que reafirmar esse translate e as duas barras se desviam por um pixel.

Use duas barras, não três. O X de três barras precisa que a do meio desapareça enquanto as duas externas convergem, e o desaparecimento é visível como um borrão cinza no meio da transição. Duas barras se transformam limpidamente. Se um estado de repouso de três barras é inegociável, anime as barras externas com translateY + rotate e dê à opacity do meio uma duração menor para que ela desapareça antes da rotação começar.

Nunca anime top/margin para mover as barras. Transform apenas.

O painel

.menu {
  position: fixed; left: 0; right: 0; top: 0;
  height: 100dvh;                      /* não inset:0 — veja Armadilha 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;   /* esconder apenas após o fade terminar */
}

.menu.is-open {
  opacity: 1; visibility: visible; transform: none;
  transition-delay: 0s;                    /* cancelar o atraso de visibilidade no caminho de entrada */
}

visibility é o que torna isso seguro para teclado: remove o painel fechado da ordem de tabulação, o que opacity: 0 sozinho não faz. A transição de visibility com atraso é todo o truque — visível imediatamente ao abrir, escondido apenas depois que o fade-out termina.

A revelação escalonada de links é o que parece caro:

.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 }

60ms de intervalo. Abaixo de ~40ms lê-se como um bloco; acima de ~90ms o último item parece atrasado. Para uma lista de comprimento desconhecido, coloque style="--i:3" em cada item e use transition-delay: calc(.10s + var(--i) * .06s).

No caminho de saída, remova os atrasos (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Uma saída escalonada faz o fechamento parecer lento — o fechamento deve ser imediato.

A função 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"])';

  // o burger é o controle de fechamento e vive fora do painel, então pertence ao 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 ? 'Fechar menu' : 'Abrir menu');
    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 o ponto de quebra não deve prender a página em um estado bloqueado
  matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
    if (e.matches) set(false);
  });
})();

inert substitui aria-hidden aqui. Nunca coloque aria-hidden="true" em um painel que pode conter foco — se o foco está dentro dele, você escondeu o elemento focado da árvore de acessibilidade, o que é um erro de autoria que leitores de tela lidam mal. inert bloqueia o foco e esconde da árvore em um único atributo.

Note o role="dialog" sem aria-modal="true". aria-modal diz à tecnologia assistiva para ignorar tudo fora do diálogo, e o botão de fechar está fora dele. Ou remova aria-modal (como acima) ou coloque um botão de fechar real dentro do painel.

Armadilha 1 — o cabeçalho deve ter prioridade sobre o painel

O burger se transforma no X, então ele precisa permanecer clicável enquanto o painel está aberto. Se o z-index do painel for maior que o do cabeçalho, o X é renderizado (é pintado no cabeçalho) mas todo clique cai na sobreposição. O menu se torna uma armadilha sem saída visível — reportado como "o botão de fechar não faz nada."

Dê ao cabeçalho um z-index maior que o do painel e verifique ambos contra todas as outras camadas fixas na página (barras de cookies e CTAs fixos são as colisões comuns). Um conjunto testado: painel 200, cabeçalho 210, toasts 9000.

Elementos fixos só se empilham uns contra os outros quando compartilham um contexto de empilhamento. Um transform, filter, opacity < 1 ou will-change em qualquer ancestral cria um novo e silenciosamente reparentaliza toda a comparação.

Armadilha 2 — overflow: hidden no body não segura iOS

document.body.style.overflow = 'hidden' bloqueia navegadores de desktop e não faz nada para um arrasto de toque no Safari do iOS. A página faz rubber-band atrás do painel e, ao soltar, o usuário está em outro lugar completamente.

O bloqueio que funciona é prender o body e restaurar o deslocamento, que é o que set() acima faz. Dois detalhes que o acompanham:

  • overscroll-behavior: contain no painel impede que a própria rolagem do painel se encadeie com a página quando atinge um limite.
  • Restaure com window.scrollTo(0, scrollY) na mesma chamada que limpa position. Ler scrollY depois que o body é destravado dá 0.

Se o seu cabeçalho é position: sticky em vez de fixed, este bloqueio o quebra. Um body preso não tem viewport de rolagem, então o sticky resolve contra o documento e o cabeçalho pula para o topo da página — para fora da tela, levando o burger junto. Troque para fixed enquanto o menu está aberto (html.is-menu-open .nav { position: fixed; top: 0 }). A skill lenis-smooth-scroll cobre a mesma falha do lado do Lenis; se essa biblioteca estiver na página, use lenis.stop() em vez de um segundo bloqueio para não empilhar ambos.

Teste o bloqueio em um deslocamento de rolagem diferente de zero. Na rolagem 0, um bloqueio quebrado é pixel-idêntico a um funcionando. Role para ~1200, abra, arraste, feche: a posição deve ler 1200 em todo o processo.

Armadilha 3 — display: none não pode ser transicionado

Alternar display pula a animação completamente: o painel aparece e desaparece instantaneamente. O padrão de visibility + transição com atraso acima é a versão que funciona em todo lugar.

O equivalente moderno, se você está disposto a exigir uma 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 é necessário — sem ele a entrada não tem valor inicial e apenas a saída é animada.

Armadilha 4 — o painel é o lugar errado para um desfoque de fundo

backdrop-filter em um painel em tela cheia reamostra tudo atrás dele a cada quadro, e em Android de gama média derruba a animação de entrada para fps de um dígito. Em uma build, remover um blend/desfoque de viewport inteiro reduziu os quadros perdidos de 34% para 3%.

Um menu premium é quase sempre um painel opaco com cores da marca, não vidro fosco. Se o design pedir vidro, desfoque um elemento pequeno (uma folha que cobre parte da tela), nunca o viewport inteiro, e veja a skill liquid-glass.

Armadilha 5 — os estados que ninguém testa

  • Redimensionar além do ponto de quebra enquanto aberto. Manipulado acima com matchMedia, não com um listener resize, então dispara uma vez na travessia em vez de a cada quadro de um arrasto.
  • Mudança de rota no lado do cliente. Na navegação Next/Astro/SPA o painel sobrevive à navegação. Chame set(false) no evento do roteador e limpe os estilos do body no desmonte.
  • Botão voltar após abrir. Se você empurra uma entrada de histórico quando o menu abre, o botão voltar deve fechá-lo em vez de deixar a página.
  • Zoom para 200%. O painel deve rolar em vez de cortar seu rodapé.
  • Telefone em paisagem. 100dvh com um painel rolável cuida disso; uma lista justify-content: center verticalmente centralizada não cuida.

Movimento reduzido

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

Mantenha as mudanças de estado, descarte a coreografia. O painel ainda deve aparecer e desaparecer.

O que o faz parecer premium

Os mecanismos acima são o básico. Estas são as escolhas que o separam de uma gaveta bootstrap:

  • Easing. cubic-bezier(.16, 1, .3, 1) (expo-out) no painel e nos links. Partida rápida, estabilização longa. Nunca ease ou linear.
  • Timing. Painel 450–600ms, links 600ms com escalonamento de 60ms, transformação do burger 450ms. Abaixo de 300ms nada é registrado como movimento; acima de 700ms parece lento.
  • Tipo. A lista de links é o design. clamp(1.65rem, 8.4vw, 2.9rem), peso da fonte 300, line-height: 1, maiúsculas, tracking apertado. Regras finas entre as linhas.
  • Numerais de índice. 01 / 02 / 03 em mono pequeno ou maiúsculas com espaçamento antes de cada rótulo, definido em um tom suave. Barato de adicionar, faz mais pela qualidade percebida do que qualquer efeito.
  • Áreas de toque em linha inteira. Padding vertical de clamp(14px, 3.4vw, 22px) na própria âncora, não uma margem ao redor, para que a linha inteira seja tocável.
  • Um estado :active, não um estado :hover. Telefones não têm hover, e um estilo hover que persiste após um toque parece quebrado.
  • Um bloco de rodapé — linha de contato, redes sociais, um único CTA em pílula — fixado por justify-content: space-between. Espaço vazio no fundo é o que faz um menu parecer um placeholder.
  • Sem bounce ou spring no próprio painel. Overshoot em uma superfície em tela cheia parece barato. Guarde spring easing para elementos pequenos.

Checklist

  • Uma função set(state) controla classe, aria-expanded, rótulo, inert e bloqueio de rolagem
  • z-index do cabeçalho está acima do painel, verificado contra todos os outros fixos

...

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.

Habilidades Relacionadas