Communitygithub.com

Biznomad - Sites Web com Animação de Vídeo ao Rolar (Scrollytel…

Construa sites com animação de rolagem de vídeo de nível Apple, scrollytelling e experiências interativas de alto desempenho usando Canvas, GSAP ScrollTrigger, Lenis e FFmpeg.

O que é Biznomad - Sites Web com Animação de Vídeo ao Rolar (Scrollytel…?

Esta skill oferece padrões arquitetônicos completos, pipelines de compressão FFmpeg e código JS/CSS de produção para criar sites altamente performáticos com animação de vídeo ao rolar, no nível de sites como Apple, Stripe e Lusion. Ela cobre três estratégias principais de renderização: Canvas Image Sequence (a mais polida e precisa), vídeo HTML5 com codificação ALL-I (rápida e leve) e shaders WebGL (para efeitos 3D avançados). A skill inclui um template completo e comentado de uma sequência de frames estilo Apple, com pré-carregador, rolagem suave via Lenis, overlays de texto com efeito glassmorphism e sincronização precisa via GSAP ScrollTrigger. Além disso, fornece os comandos FFmpeg necessários para preparar vídeos (codificação ALL-I com keyframe a cada frame) ou extrair sequências de imagens para canvas. Ideal para desenvolvedores que buscam implementar experiências de scrollytelling de alta qualidade, replicando o acabamento e a fluidez dos principais sites de design do mundo, suportando plataformas como Claude Code, Cursor e Codex.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-scroll-website

Perguntar na sua IA favorita

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

Documentação

Biznomad – Sites Web com Animação de Vídeo ao Rolar (Scrollytelling de Nível Apple)

Esta skill fornece padrões arquitetônicos completos, pipelines de compressão FFmpeg e código JS/CSS de produção para construir sites de alto desempenho com animação de vídeo ao rolar, no padrão dos sites da Apple, Stripe, Lusion e Awwwards Site-of-the-Day.


Pesquisa do Setor e Análise Arquitetônica

Ao construir experiências de vídeo acionadas por rolagem, as principais agências de tecnologia e design selecionam entre três estratégias primárias de renderização:

EstratégiaReferência do SetorMelhor paraPrósContras
Canvas Image SequenceApple (MacBook, AirPods, iPhone)Precisão ao arrastar, lag zero, quadro perfeitoExtremamente suave a 60–120fps, funciona em GPUs móveisRequer pré-carregamento de quadros (array de 20–60MB)
Vídeo HTML5 Codificado com ALL-IStripe, Nike, TeslaConfiguração rápida, largura de banda baixa (arquivo único)Único download MP4, inicialização rápidaRequer distância curta entre keyframes (-g 1)
Shader WebGLLusion, Active Theory, CubertoDistorção 3D, efeitos de vidro líquidoAltamente criativo, controle de iluminação e refraçãoMaior carga na GPU, complexidade do shader

1. Preparação de Vídeo e Pipeline de Codificação FFmpeg

Para obter avanço de quadro instantâneo e suave, o vídeo DEVE ser codificado com distância de keyframe igual a 1 (cada quadro é um Intra-frame / Keyframe).

Opção A: Preparar Vídeo para Avanço em Vídeo HTML5 (Codificação ALL-I)

Execute este comando FFmpeg para gerar um MP4 de avanço ultrarrápido:

ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -preset slow -crf 18 -g 1 -keyint_min 1 -an -movflags +faststart output_scrub.mp4

Opção B: Preparar Sequência de Quadros para Avanço em Canvas (Estilo Apple)

Extraia quadros comprimidos em WebP ou JPEG 1080p:

mkdir -p frames
ffmpeg -i input.mp4 -vf "scale=1920:1080" -q:v 85 frames/frame_%04d.jpg
# Ou para WebP (tamanho de arquivo menor):
ffmpeg -i input.mp4 -vf "scale=1920:1080" -c:v libwebp -quality 85 frames/frame_%04d.webp

2. Configuração da Stack Técnica

  • Mecanismo de Rolagem Suave: @studio-freight/lenis ou Lenis (elimina tremores e fornece rolagem com momentum)
  • Driver de Animação: GSAP 3.12+ com ScrollTrigger
  • Camada de Renderização: <canvas> com Contexto 2D ou <video> com sincronização currentTime
  • Tipografia e HUD: Cartões sobrepostos fixos com efeito glassmorphism sincronizados com os gatilhos da linha do tempo

3. Arquitetura de Produção: Sequência Canvas Estilo Apple (Recomendado)

Abaixo está a implementação pronta para produção de uma sequência de frames em canvas estilo Apple, com pré-carregador, rolagem suave Lenis e camadas de texto scrollytelling flutuantes.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<title>Apple-Style Video Scroll Showcase</title>

<!-- Fontes & CDNs GSAP + Lenis -->
<link rel="preconnect" href="https://fonts.googleapis.com"/>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;800;900&family=JetBrains+Mono:wght@500;700&display=swap" rel="stylesheet"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/lenis.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>

<style>
  :root {
    --bg: #000000;
    --paper: #f5f5f7;
    --dim: #86868b;
    --accent: #2997ff;
    --accent-glow: rgba(41, 151, 255, 0.35);
    --panel: rgba(22, 22, 23, 0.75);
    --line: rgba(255, 255, 255, 0.12);
  }

  * { box-sizing: border-box; margin: 0; padding: 0; }
  body {
    background: var(--bg);
    color: var(--paper);
    font-family: "Inter", system-ui, -apple-system, sans-serif;
    overflow-x: hidden;
    -webkit-font-smoothing: antialiased;
  }

  /* Pré-carregador */
  #preloader {
    position: fixed;
    inset: 0;
    z-index: 999;
    background: #000;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    gap: 16px;
    transition: opacity 0.6s ease, visibility 0.6s ease;
  }
  #preloader.done { opacity: 0; visibility: hidden; }
  .loader-bar {
    width: 200px;
    height: 3px;
    background: rgba(255, 255, 255, 0.15);
    border-radius: 999px;
    overflow: hidden;
  }
  .loader-fill {
    height: 100%;
    width: 0%;
    background: var(--accent);
    transition: width 0.1s linear;
  }

  /* Estágio de Rolagem com Canvas Fixo */
  .scroll-stage {
    position: relative;
    height: 400vh; /* Determina a duração da interação de rolagem */
  }
  .sticky-viewport {
    position: sticky;
    top: 0;
    width: 100vw;
    height: 100vh;
    overflow: hidden;
    display: flex;
    align-items: center;
    justify-content: center;
  }
  canvas#scrollCanvas {
    width: 100%;
    height: 100%;
    object-fit: cover;
    display: block;
  }

  /* Painéis Flutuantes de Scrollytelling */
  .hud-overlay {
    position: absolute;
    inset: 0;
    pointer-events: none;
    z-index: 10;
  }
  .hud-card {
    position: absolute;
    max-width: 460px;
    background: var(--panel);
    backdrop-filter: blur(20px);
    -webkit-backdrop-filter: blur(20px);
    border: 1px solid var(--line);
    border-radius: 20px;
    padding: 32px;
    opacity: 0;
    transform: translateY(30px);
    transition: opacity 0.5s ease, transform 0.5s ease;
  }
  .hud-card.active {
    opacity: 1;
    transform: translateY(0);
  }
  .hud-eyebrow {
    font-family: "JetBrains Mono", monospace;
    color: var(--accent);
    font-size: 12px;
    letter-spacing: 0.15em;
    text-transform: uppercase;
    font-weight: 700;
    margin-bottom: 8px;
  }
  .hud-title {
    font-size: 32px;
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.1;
    margin-bottom: 12px;
  }
  .hud-desc {
    color: var(--dim);
    font-size: 15px;
    line-height: 1.6;
  }

  /* Posições Individuais do HUD */
  .hud-1 { top: 15%; left: 8%; }
  .hud-2 { top: 35%; right: 8%; }
  .hud-3 { bottom: 15%; left: 8%; }

  /* Seção Final */
  .outro-sec {
    min-height: 100vh;
    display: flex;
    align-items: center;
    justify-content: center;
    text-align: center;
    background: #08080a;
    border-top: 1px solid var(--line);
    padding: 80px 24px;
  }
  .outro-title {
    font-size: clamp(40px, 6vw, 84px);
    font-weight: 900;
    letter-spacing: -0.04em;
    margin-bottom: 24px;
  }
  .btn-cta {
    display: inline-block;
    background: var(--accent);
    color: #fff;
    font-weight: 700;
    padding: 16px 36px;
    border-radius: 999px;
    text-decoration: none;
    box-shadow: 0 10px 30px var(--accent-glow);
    transition: transform 0.2s;
  }
  .btn-cta:hover { transform: scale(1.05); }
</style>
</head>
<body>

<!-- Pré-carregador -->
<div id="preloader">
  <div style="font-weight:700;font-size:14px;letter-spacing:0.1em">CARREGANDO EXPERIÊNCIA</div>
  <div class="loader-bar"><div class="loader-fill" id="loaderFill"></div></div>
</div>

<!-- Contêiner de Rolagem com Vídeo -->
<div class="scroll-stage" id="scrollStage">
  <div class="sticky-viewport">
    <canvas id="scrollCanvas"></canvas>

    <!-- Overlays de Scrollytelling HUD -->
    <div class="hud-overlay">
      <div class="hud-card hud-1" id="hud1">
        <div class="hud-eyebrow">01 / ARQUITETURA</div>
        <h2 class="hud-title">Precisão Projetada.</h2>
        <p class="hud-desc">Cada quadro calculado em tempo real. Velocidade visual e capacidade de resposta incomparáveis.</p>
      </div>

      <div class="hud-card hud-2" id="hud2">
        <div class="hud-eyebrow">02 / TELEMETRIA</div>
        <h2 class="hud-title">Fluxo de Dados em Tempo Real.</h2>
        <p class="hud-desc">Sincronização de submilissegundos entre a entrada de rolagem do usuário e a apresentação no canvas.</p>
      </div>

      <div class="hud-card hud-3" id="hud3">
        <div class="hud-eyebrow">03 / DESEMPENHO</div>
        <h2 class="hud-title">Domínio de 120 FPS.</h2>
        <p class="hud-desc">Renderização de canvas acelerada por GPU sem queda de quadros ou gaguejos na rolagem.</p>
      </div>
    </div>
  </div>
</div>

<section class="outro-sec">
  <div>
    <h1 class="outro-title">Pronto para Lançar.</h1>
    <a href="#" class="btn-cta">EXPERIMENTE O FUTURO →</a>
  </div>
</section>

<script>
document.addEventListener('DOMContentLoaded', () => {
  // 1. Inicializar Rolagem Suave Lenis
  const lenis = new Lenis({
    duration: 1.2,
    easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
    smoothWheel: true
  });

  function raf(time) {
    lenis.raf(time);
    requestAnimationFrame(raf);
  }
  requestAnimationFrame(raf);

  // Sincronizar Lenis com GSAP ScrollTrigger
  lenis.on('scroll', ScrollTrigger.update);
  gsap.ticker.add((time) => lenis.raf(time * 1000));
  gsap.ticker.lagSmoothing(0);

  // 2. Configurar Canvas e Pré-carregador de Imagens
  const canvas = document.getElementById('scrollCanvas');
  const ctx = canvas.getContext('2d');
  const loaderFill = document.getElementById('loaderFill');
  const preloader = document.getElementById('preloader');

  const totalFrames = 120; // Número de quadros extraídos
  const images = [];
  const airbnb = { frame: 0 };

  // Gerador de URL de quadro (Substitua pelo seu caminho relativo)
  const currentFrame = (index) => `./frames/frame_${(index + 1).toString().padStart(4, '0')}.jpg`;

  let loadedCount = 0;
  for (let i = 0; i < totalFrames; i++) {
    const img = new Image();
    img.src = currentFrame(i);
    img.onload = () => {
      loadedCount++;
      loaderFill.style.width = `${(loadedCount / totalFrames) * 100}%`;
      if (loadedCount === totalFrames) {
        preloader.classList.add('done');
        renderCanvas();
      }
    };
    images.push(img);
  }

  // Lidar com Telas Retina de Alta Resolução (DPR)
  function resizeCanvas() {
    const dpr = window.devicePixelRatio || 1;
    canvas.width = window.innerWidth * dpr;
    canvas.height = window.innerHeight * dpr;
    ctx.scale(dpr, dpr);
    renderCanvas();
  }
  window.addEventListener('resize', resizeCanvas);

  function renderCanvas() {
    if (!images[airbnb.frame]) return;
    const img = images[airbnb.frame];
    const w = window.innerWidth;
    const h = window.innerHeight;

    // Matemática para Ajuste de Cobertura (Cover Fit)
    const imgRatio = img.width / img.height;
    const canvasRatio = w / h;
    let drawW, drawH, offsetX, offsetY;

    if (canvasRatio > imgRatio) {
      drawW = w;
      drawH = w / imgRatio;
      offsetX = 0;
      offsetY = (h - drawH) / 2;
    } else {
      drawW = h * imgRatio;
      drawH = h;
      offsetX = (w - drawW) / 2;
      offsetY = 0;
    }

    ctx.clearRect(0, 0, w, h);
    ctx.drawImage(img, offsetX, offsetY, drawW, drawH);
  }

  // Redimensionamento Inicial do Canvas
  resizeCanvas();

  // 3. Sequência GSAP ScrollTrigger
  gsap.to(airbnb, {
    frame: totalFrames - 1,
    snap: "frame",
    ease: "none",
    scrollTrigger: {
      trigger: "#scrollStage",
      start: "top top",
      end: "bottom bottom",
      scrub: 0.5,
      onUpdate: () => renderCanvas()
    }
  });

  // 4. Gatilhos para Overlays de Scrollytelling HUD
  function setupHudTrigger(id, startPct, endPct) {
    ScrollTrigger.create({
      trigger: "#scrollStage",
      start: `${startPct}% top`,
      end: `${endPct}% top`,
      onEnter: () => document.getElementById(id).classList.add('active'),
      onLeave: () => document.getElementById(id).classList.remove('active'),
      onEnterBack: () => document.getElementById(id).classList.add('active'),
      onLeaveBack: () => document.getElementById(id).classList.remove('active')
    });
  }

  setupHudTrigger('hud1', 10, 30);
  setupHudTrigger('hud2', 35, 60);
  setupHudTrigger('hud3', 65, 90);
});
</script>

</body>
</html>

4. Arquitetura Alternativa: Avanço Direto em Vídeo HTML5

Para projetos usando um único arquivo .mp4 comprimido com codificação Intra-frame (-g 1):

const video = document.getElementById('scrubVideo');
video.pause();

// Garantir que os metadados sejam carregados para a duração
video.onloadedmetadata = function() {
  gsap.to(video, {
    currentTime: video.duration,
    ease: "none",
    scrollTrigger: {
      trigger: "#videoStage",
      start: "top top",
      end: "bottom bottom",
      scrub: 0.3
    }
  });
};

5. Regras de Ouro para Qualidade Apple

  1. Keyframes Intra-frame (-g 1): Obrigatório para avanço em vídeo HTML5, caso contrário o avanço fica instável nos intervalos de busca de keyframes.
  2. Proporção de Pixels do Dispositivo (DPR): Sempre dimensione a resolução do canvas por window.devicePixelRatio para uma saída Retina nítida.
  3. Matemática de Cobertura de Proporção: Calcule offsetX e offsetY ao redimensionar o canvas para que os quadros mantenham a cobertura object-fit completa.
  4. Interpolação de Rolagem Lenis: Nunca omita a inércia de rolagem suave (Lenis). Eventos de roda nativos criam etapas discretas que degradam o avanço do vídeo.
  5. Fallback de Performance Móvel: Em dispositivos móveis de baixa potência (matchMedia('(prefers-reduced-motion: reduce)') ou baixa largura de banda), ofereça reprodução automática de vídeo ou frames estáticos em vez de cálculos pesados de avanço.

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Habilidades Relacionadas