Communitygithub.com

omd-shader-hero — uma cena, duas tintas da marca

Um herói de lançamento em tela cheia com duas tintas extraídas do DESIGN.md do projeto: a cor base e exatamente uma cor da marca, como um campo de pontilhado ordenado (Bayer) que se dobra lentamente — um visual de impressão risográfica, não um gradiente genérico.

O que é omd-shader-hero — uma cena, duas tintas da marca?

Esta skill gera um componente de herói (hero) de tela cheia para páginas de lançamento, produto, lista de espera ou rebranding, usando exatamente duas cores planas extraídas automaticamente de um arquivo DESIGN.md: a cor base e uma cor da marca. O efeito visual é um campo de pontilhado ordenado (Bayer) que se dobra lentamente, simulando a estética de impressão risográfica, sem misturar as cores — cada pixel é uma tinta ou outra, eliminando a formação de tons turvos. O texto (título e subtítulo) é exibido sobre um recorte opaco na tinta base, garantindo contraste mínimo de 4.5:1 verificado em todos os quadros da animação. A skill suporta dois formatos de campo: dobras diagonais (padrão) ou ondas concêntricas, controlados por atributo data-shape. Inclui fallback em CSS (pôster de meio-tom), respeita prefers-reduced-motion e tem aproximadamente 7 KiB gzip de JavaScript. É invocável pelo usuário com o argumento do caminho do DESIGN.md e opção de esquema claro/escuro. A skill lê tokens do Core v2 e frontmatter compatível com Google, recusa-se a inventar cores e verifica a saída em GPU real com Playwright.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-shader-hero/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

O que omd-shader-hero — uma cena, duas tintas da marca faz?

Um herói de lançamento tem uma chance com alguém que não te deve nada. Gradientes mesh são o visual de shader mais genérico da web, e misturar dois tons complementares da marca os transforma em marrom. Esta skill faz o oposto: duas tintas planas, a cor base e uma cor da marca, impressas como um campo de pontilhado ordenado que se dobra lentamente como luz através de uma tela de serigrafia. Cada pixel é uma tinta ou outra, então nada se mistura e nada fica turvo. O texto fica sobre um recorte de borda dura na tinta base, como um painel recortado em um pôster risográfico.

O script escolhe ambas as tintas, a cor do texto e o contraste a partir de DESIGN.md. Nenhuma cor é escolhida por gosto.

Exemplo funcional: examples/hero.html, preenchido a partir do fictício examples/DESIGN.example.md. Scripts: scripts/tokens.mjs (tintas + contraste), scripts/verify.mjs (prova de renderização real).

1. Quando usar / quando não usar

Use quando:

  • uma página de lançamento, produto, lista de espera, evento ou rebranding precisa de uma primeira tela com movimento;
  • o projeto tem um DESIGN.md com uma cor da marca e uma base escura (ou clara) (tokens Core v2 Foundations, pares de prosa do Foundations ou frontmatter colors: compatível com Google);
  • um visual gráfico, impresso e confiante se encaixa na marca.

Não use quando:

  • não há DESIGN.md ou nenhuma cor da marca. tokens.mjs sai com código 3 e você para; execute omd-init ou pergunte. Nunca escolha cores "bonitas" para preencher a lacuna (desconhecido significa ausente);
  • a marca é suave, fotográfica ou de luxo silencioso. Um campo de pontilhado é barulhento. Use a fotografia do briefing (tf-shaders "photo first");
  • a página precisa de várias cenas de shader. Uma cena, mais no máximo um pequeno acento em outro lugar (regra tf-shaders). Para uma história de rolagem completa, use omd-landing.

2. Procedimento

  1. Leia os tokens, não os escolha.
    node <skill>/scripts/tokens.mjs DESIGN.md                 # imprime a decisão como JSON
    node <skill>/scripts/tokens.mjs DESIGN.md --scheme light  # base clara em vez de escura
    
    O script lê três formatos, nesta ordem: tokens - **color.<role>**: \#hex`, pares Name (`#hex`)dentro da seção Foundations e então frontmattercolors:`. Em seguida, ele:
    • descarta papéis de estado e utilitários (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active);
    • pega o token mais escuro como a tinta base (o mais claro para light);
    • pega uma tinta da marca: o papel chamado primary/brand se houver, senão a cor da marca mais saturada, ignorando qualquer uma muito próxima da base.
  2. A cor do texto é calculada. O script verifica os candidatos a texto (tokens de tinta/neutro no extremo oposto do esquema) contra ambas as tintas e seu ponto médio e escolhe o melhor. O texto então fica sobre um recorte opaco na tinta base, então a barra que ele deve ultrapassar é o token de texto sobre a tinta base. Com o dispositivo de teste, isso é 18.8:1. Se mesmo assim estiver abaixo de 4.5:1, o script avisa: escolha outro token de texto.
  3. Escreva o herói. Copie examples/hero.html (ou porte-o, veja §6) e preencha:
    node <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html
    
    Isso reescreve o bloco CSS #hero-vars (--hero-c0 base, --hero-c1 marca, --hero-text, --hero-scrim, --hero-scrim-a) e o JSON #hero-tokens.
  4. O texto é real. Título + uma frase + um CTA. Use a linha de produto real do usuário. Nunca invente métricas, clientes ou investidores (tf-shaders §0).
  5. Verifique em uma GPU real (§5) e observe os quadros em tamanho real.

3. A cena e seus dois parâmetros

ditheringFragmentShader do Paper: type = 4x4 (Bayer ordenado), colorBack = tinta base, colorFront = tinta da marca, e uma das duas formas de campo escolhidas com data-shape em .hero-scene:

data-shapeCampoInterpretação
warp (padrão)dobras diagonais lentas da luz da marca, escala 1um pôster risográfico, energia em dois cantos
rippleanéis concêntricos centrados no herói, atrás do texto, escala 0.5uma impressão com centro de gravidade: o texto fica no olho

A forma é uma escolha de composição, não um terceiro parâmetro: a escala de cada forma é fixa para que suas células sejam lidas em px 2–6, e um valor desconhecido cai para warp. Ambas as formas permanecem duas tintas planas (verificado por contagem de pixels, §5). As outras formas de pontilhado do Paper e seus outros shaders foram deixados de fora: a maioria mistura as duas cores nas bordas, o que quebra a regra para a qual esta skill existe.

ParâmetroFaixaPadrãoO que faz
speed (data-speed)0–10.3Deriva das dobras. Acima de ~0.6 parece um protetor de tela. 0 congela o campo.
px (data-px)2–6 CSS px3Tamanho da célula de pontilhado. 2 = tela fina, 3 = risográfico, 5–6 = impressão grossa.

Regras de layout:

  • Recorte, não véu. A caixa de texto fica em um painel opaco na tinta base com bordas duras (inset 2rem × 2.5rem ao redor do texto). Um véu translúcido, ou uma borda suave, sobreporia base sobre pontos da marca e recriaria a turvação. Texto pequeno (o rótulo do rodapé) também tem seu próprio recorte.
  • Contraste: 4.5:1 para o título e o subtítulo. O título é grande o suficiente para que o WCAG aceitasse 3:1, mas esta skill não depende disso. verify.mjs falha abaixo de 4.5:1 para qualquer um.
  • O texto do herói é pintado no primeiro quadro: sem opacity: 0, sem esperar pelo canvas. O canvas aparece gradualmente em 600ms sobre um pôster CSS já completo.
  • O pôster também é de duas tintas. Ele segue a forma (cantos para warp, anéis para ripple, dispostos após o quadro estático) e obtém seu tom do tamanho do ponto em duas bandas de borda dura (quadrados 4×4 nos núcleos, 2×2 nas bordas), nunca de alfa: uma máscara desbotada misturaria marca sobre base. Pontos quadrados em pixels inteiros, como as células Bayer.
  • Tipografia coreana segue /hangul: keep-all + overflow-wrap: anywhere, line-height 1.3, tracking -0.02em (nunca abaixo de -0.03em), text-wrap: balance, font-synthesis: none.
  • Fundo em html, nunca em body (um fundo de body pinta sobre uma cena com z negativo; armadilha tf-shaders).
  • Raio, escala tipográfica e espaçamento vêm do DESIGN.md também. O dispositivo de teste não define raio, então o CTA é quadrado.

4. Biblioteca, licença, orçamento, fallback

Biblioteca: @paper-design/shaders 0.0.82 (vanilla ShaderMount + ditheringFragmentShader), WebGL2. 0.0.82 (2026-10-21) altera apenas shader-mount.js: dispose() agora libera o contexto WebGL. Licenças verificadas em 2026-10-13 a partir dos arquivos LICENSE dos tarballs npm, metadados npm e API de licença do GitHub:

@paper-design/shaders 0.0.81shaders 4.0.4 (shaders.com)
LicençaApache-2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper")MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT
RuntimeWebGL2, quase universalWebGPU apenas; canvas transparente e sem log quando não suportado
JS para esta cena23.7 KiB min / 7.0 KiB gzip (esbuild); CDN por arquivo +esm 5.0 + 2.9 KiB gzip2,535 KiB min / 710 KiB gzip (Shader + MeshGradient)
Telemetrianenhumaativada por padrão (amostragem de 5% para shaders.com/api/telemetry); se precisar usar, passe disableTelemetry
Downloads semanais npm (2026-10-05..11)1,104,377 (-react)287,493

Paper vence em alcance, peso e telemetria. shaders é o caminho de upgrade apenas para um projeto que já envia cenas WebGPU. Lá, mantenha este pipeline de tokens, o recorte e o fallback, e passe disableTelemetry. Ambas as licenças permitem uso em skills e templates. O exemplo importa o Paper de uma URL CDN fixa e não o fornece. Se você fornecer os arquivos do Paper, copie seu NOTICE junto.

Orçamento:

  • JS: 7.0 KiB gzip de biblioteca + 1.1 KiB gzip de código da cena.
  • GPU: um quadrilátero em tela cheia, duas cores, pontilhado ordenado. minPixelRatio: 1 e maxPixelCount 1920×1080, já que o tamanho da célula é a resolução. O Paper pausa fora da tela e em abas ocultas.
  • Sem imagens, sem vídeo, sem fonte além da face da UI.

Fallback (parte do design, não um pensamento posterior):

  • Pôster de meio-tom CSS sob o canvas: pontos da tinta da marca na tinta base (radial-gradient células de 6px), mascarado em direção a dois cantos. É a primeira pintura, o caminho sem WebGL2 (ShaderMount lança erro sem contexto; a página testa getContext('webgl2') primeiro) e o estado quando a CDN está inacessível. verify.mjs força este caminho.
  • prefers-reduced-motion: reduce: velocidade 0 em um quadro fixo (STILL_FRAME, 8000ms). Isso é uma composição estática sem loop rAF.

5. Verifique em uma GPU real

npm i -D playwright-core && npx playwright-core install chromium   # Playwright Chromium novo, não seu Chrome
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all

--shape warp|ripple|all define data-shape antes do módulo da página ser executado. Para cada forma, executa quatro passagens (GPU 1440px, mobile 390px, movimento reduzido, sem WebGL) com --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), e para cada uma:

  • registra o renderizador WebGL, para que você saiba se uma GPU real ou SwiftShader desenhou os quadros;
  • avança o relógio do shader deterministicamente ao longo de 12s e salva quadros (ffmpeg → GIF/MP4 de demonstração);
  • mede contraste: esconde o texto, amostra a cena atrás do título e subtítulo em cada quadro e calcula a pior proporção contra a cor do texto. Falha abaixo de 4.5:1 para qualquer um;
  • conta as tintas: fora dos recortes, cada pixel do canvas e do pôster CSS deve ser a tinta base ou a tinta da marca (twoInksScene, twoInksPoster);
  • pôster antes do canvas, a partir do relógio da própria página: um script de inicialização amostra cada quadro renderizado e registra o primeiro quadro em que o pôster está na tela e o primeiro quadro em que o canvas desenhou e não é transparente, além do tempo de pintura e LCP;
  • tempo de quadro na passagem GPU: intervalos rAF por 3 s enquanto o campo roda, mediana e p95;
  • verifica se o canvas (não o pôster) está na tela, se o campo se move, se o título está com opacidade total no carregamento, se o movimento reduzido está parado e se a versão sem WebGL mostra o pôster sem canvas.

Medido em 2026-11-06 com o dispositivo de teste (Chromium headless, ANGLE Metal Renderer: Apple M5 Pro), todas as verificações passaram para ambas as formas:

FormaPior título / subtítuloPixels de outra tinta (cena / pôster)Quadro do pôster → quadro do canvas (passagem GPU)ms do quadro (mediana / p95)
warp18.81 / 18.81 em todas as quatro passagens0 / 062 → 112 ms8.3 / 9.2
ripple18.81 / 18.81 em todas as quatro passagens0 / 044 → 127 ms8.3 / 9.2

6. Porte para Next.js / React

Renderize no servidor a seção, o texto, o recorte e o pôster como HTML/CSS simples (o pôster não precisa de JS). Gere as variáveis CSS em tempo de build a partir de tokens.mjs --json, não em tempo de execução. Monte a cena em uma folha 'use client':

useEffect(() => {
  if (!probeWebGL2() || !ref.current) return;           // pôster permanece; nada a limpar
  let m: { dispose(): void } | undefined;
  (async () => {
    const { ShaderMount, ditheringFragmentShader } = await import('@paper-design/shaders');
    try { m = new ShaderMount(ref.current!, ditheringFragmentShader, uniforms, undefined, reduce ? 0 : speed, 8000, 1, 1920 * 1080); }
    catch { /* mantém o pôster */ }
  })();
  return () => m?.dispose();
}, []);

7. Atribuição

Do experimento tf-shaders do proprietário (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10): uma cena mais no máximo um acento, o orçamento JS declarado, o pôster CSS sob cada canvas, fundo em html, estado silencioso atrás do tipo, contraste verificado no pior quadro, texto do herói no primeiro quadro, movimento reduzido como mudança de estado e o loop de captura de tela em GPU real. Esta skill adiciona o pipeline de tokens, o pontilhado de duas tintas, o recorte, o contraste medido e a escolha de runtime WebGL2.

Não faça

  • Não adicione uma terceira cor nem misture as duas tintas (gradientes, sobreposições translúcidas, painéis com bordas suaves). Duas tintas planas são o ponto principal; uma mistura entre tons complementares é lama.
  • Não use uma cor que não seja um token do DESIGN.md, e nunca uma cor de estado (vermelho de perigo como tinta da marca).
  • Não coloque texto diretamente no campo de pontilhado. O texto vai sobre o recorte; texto pequeno tem seu próprio.
  • Não troque shaders por ponto de quebra nem anime propriedades de tempo de compilação. Alterar um valor de tinta ou px é uma escrita uniforme e é aceitável.
  • Não empilhe o herói sobre um fundo de body, e não faça o título aparecer gradualmente.
  • Não carregue Paper e shaders na mesma página.

Habilidades Relacionadas