Communitygithub.com

nicolas2601/router-skills

Modelo completo para landing premium estilo Apple/Stripe/Sony Bravia com 9 seções tipificadas (navbar pill liquid-glass + hero scroll-scrub canvas + serviços bento assimétrico + por que nós 4-col + processo numerado + stats com vídeo bg + depoimentos marquee duplo + FAQ 2-col + CTA cinematográfico + footer). Stack obrigatório Vite + React 18 + TS + Tailwind v4 + shadcn/ui + Framer Motion + lucide-react + @fontsource. Gatilho landing premium cinematográfica, estilo Apple, scroll-scrub vídeo, hero canvas, landing nível Awwwards.

O que é router-skills?

Este skill fornece um template prescritivo e detalhado para criar landings premium de alto nível, inspiradas em marcas como Apple (AirPods Pro), Stripe e Sony Bravia. Ele é projetado para desenvolvedores que desejam construir páginas cinematográficas com efeitos avançados de scroll scrub em canvas, sem precisar partir do zero. O template impõe um stack tecnológico obrigatório (Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion + lucide-react) e uma estrutura de 9 seções específicas com padrões rigorosos de estilo, animação e responsividade. O componente central é o hero com canvas de scroll scrub (inspirado no Apple AirPods Pro), onde o usuário desliza e vê uma sequência de frames renderizados em um elemento canvas. Além disso, inclui uma barra de navegação flutuante com efeito liquid-glass, seções de serviços em grid bento assimétrico, depoimentos em marquee duplo, FAQ em duas colunas, e um CTA com fundo de vídeo. O template já define design tokens (paleta quente: ochre, terra, cream, ink), utilitários CSS para efeito liquid-glass, cinco primitivas de animação (BlurText, fade-up-on-view, scroll-scrub canvas, marquee, border liquid-glass) e 15 regras anti-slop para evitar más práticas comuns, como uso de placeholders lorem ipsum ou gradientes roxos padrão. Há também orientações para extração de frames de vídeo (via FFmpeg) e verificação de desempenho (Lighthouse, LCP). A saída final é um projeto funcional, responsivo (1440px desktop, 375px mobile), acessível e otimizado para deploy em plataformas como Vercel.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nicolas2601/router-skills/tree/HEAD/skills/cinematic-landing-template

Perguntar na sua IA favorita

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

Documentação

Modelo de Landing Cinematográfica

Modelo prescritivo para landing premium com hero de scroll scrub em canvas. Inspirado em Apple AirPods Pro, Stripe, Sony Bravia.

Stack obrigatório (não substituir)

npm create vite@latest . -- --template react-ts
npm install
npm install -D tailwindcss@next @tailwindcss/vite @tailwindcss/postcss autoprefixer
npm install motion lucide-react
npm install @fontsource/{display-font} @fontsource/{body-font}
npx shadcn@latest init -d
npx shadcn@latest add button accordion

Estrutura de arquivos

src/
  App.tsx
  main.tsx
  index.css                  # design tokens + Tailwind @theme + utilitários liquid-glass
  components/
    ScrubSequence.tsx        # renderizador de frames em canvas (CRÍTICO)
    BlurText.tsx             # título com efeito word-stagger (CRÍTICO)
    Navbar.tsx               # pill flutuante liquid-glass
    Hero.tsx                 # canvas scroll-scrub + título + CTAs
    ServicesBento.tsx        # bento assimétrico com 6 cards
    Pourquoi.tsx             # grid 4-col why-us
    Process.tsx              # fluxo horizontal numerado de 3-4 etapas
    Stats.tsx                # vídeo de fundo + 4 estatísticas com contagem
    Testimonials.tsx         # 2 linhas de marquee em direções opostas
    Faq.tsx                  # layout de 2 colunas (título fixo + accordion)
    CtaFooter.tsx            # vídeo de fundo cinematográfico + CTA + barra de footer
    ui/
      button.tsx             # com variantes hero, heroGlass, heroSolid
      accordion.tsx
  lib/
    utils.ts
    constants.ts             # FRAME_COUNT, FRAMES_PATH, FRAME_EXT
public/
  frames/                    # frame_0001.jpg ... frame_NNNN.jpg

As 9 seções — padrões obrigatórios

1. Navbar (pill flutuante liquid-glass)

  • fixed top-4 left-1/2 -translate-x-1/2 z-50 com liquid-glass rounded-full px-2 py-2
  • 3 zonas: logotipo+marca (esquerda) | links de navegação centro (md+) | CTA (direita)
  • Scroll > 40px: top-4 → top-2 + backdrop-blur-xl
  • Mobile: hambúrguer + sheet em tela cheia liquid-glass

2. Hero (scroll-scrub canvas)

  • <section ref={scrollRef} className="relative h-[250vh]"> (250vh fornece scroll para sequência de frames)
  • <div className="sticky top-0 h-screen overflow-hidden"> para fixar
  • Canvas absoluto inset-0 z-0
  • Vinheta radial com gradiente z-1
  • Fade inferior z-2 em direção à próxima seção
  • Conteúdo (badge + BlurText H1 + sub + CTAs + marquee de parceiros) z-10

3. ServicesBento (assimétrico com 6 cards)

  • Grid md:grid-cols-3 gap-5
  • Card 0: alto row-span-2
  • Cards 1-2: pequenos
  • Card 3: largo col-span-2
  • Card 4: pequeno
  • Card 5: largura total col-span-3
  • Cada card: liquid-glass rounded-2xl + ícone em liquid-glass-strong rounded-full size-11 + título display + corpo com 38 caracteres + ArrowUpRight no canto superior direito

4. Pourquoi (4-col why-us)

  • Grid lg:grid-cols-4 gap-5 mt-16
  • Cada card: liquid-glass + ícone + título display + corpo com 30 caracteres + linha de destaque inferior

5. Process (numerado horizontal)

  • md:grid-cols-4 gap-0 (gap-0 pois os conectores preenchem o espaço)
  • Número gigante text-[140px] text-primary/25 sobrepondo
  • Conector horizontal: absolute top-20 -right-0 h-px w-full bg-gradient-to-r from-border via-border to-transparent

6. Stats (vídeo de fundo + contagem)

  • Vídeo de fundo filter saturate(0) dessaturado
  • Gradientes de 200px no topo e na base
  • Card central liquid-glass rounded-3xl p-14
  • 4 estatísticas: valor font-display italic text-7xl + rótulo uppercase tracking-wide text-sm
  • Animar contagem de 0 usando motion quando entra no viewport

7. Testimonials (2 linhas de marquee)

  • Linha 1: animate-[marquee_28s_linear_infinite]
  • Linha 2: animate-[marquee-rev_32s_linear_infinite] (direção oposta)
  • Máscara: [mask-image:linear-gradient(to_right,transparent,black_8%,black_92%,transparent)]
  • Pausar ao passar o mouse: hover:[animation-play-state:paused]

8. FAQ (layout de 2 colunas)

  • Grid md:grid-cols-[0.9fr_1.1fr] gap-16
  • Esquerda: fixa md:sticky md:top-24 com badge + título display + parágrafo + botão
  • Direita: shadcn Accordion com itens estilizados

9. CTA + Footer

  • Vídeo de fundo filter brightness(0.55) (NÃO saturate-0 aqui — diferente de Stats)
  • Título font-display italic text-[180px] (NÃO uppercase aqui — itálico é outro estilo)
  • Footer: border-top + direitos autorais + links de footer

Design tokens (index.css)

@import "@fontsource/{display-font}/400.css";
@import "@fontsource/{display-font}/700.css";
@import "@fontsource/{body-font}/400.css";
@import "tailwindcss";

:root {
  /* Triplas HSL da paleta crua (sem wrapper hsl() para alfa no Tailwind) */
  --ink:    20 15% 9%;
  --cream:  40 30% 90%;
  --ochre:  32 55% 65%;
  --terra:  14 55% 31%;

  /* Semântica */
  --background: var(--ink);
  --foreground: var(--cream);
  --primary: var(--ochre);
  --secondary: var(--terra);
  --muted: 240 4% 16%;
  --muted-foreground: 40 6% 72%;
  --border: 40 30% 90% / 0.18;
  --ring: var(--ochre);
  --radius: 0.75rem;

  /* Tipografia */
  --font-display: "Oswald", "Impact", sans-serif;
  --font-body: "Inter", -apple-system, sans-serif;

  /* Layout */
  --gutter: clamp(20px, 4.2vw, 56px);
  --max: 1440px;
}

@theme {
  --color-background: hsl(var(--background));
  --color-foreground: hsl(var(--foreground));
  --color-primary: hsl(var(--primary));
  /* ... demais tokens semânticos */
  --animate-marquee: marquee 28s linear infinite;
  --animate-marquee-rev: marquee-rev 32s linear infinite;
}

@keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }
@keyframes marquee-rev { from { transform: translateX(-50%) } to { transform: translateX(0) } }

Utilitários Liquid-glass (@layer components)

.liquid-glass {
  background: rgba(255,255,255,0.01);
  background-blend-mode: luminosity;
  backdrop-filter: blur(4px);
  border: none;
  box-shadow: inset 0 1px 1px rgba(255,255,255,0.1);
  position: relative;
  overflow: hidden;
}
.liquid-glass::before {
  content: '';
  position: absolute;
  inset: 0;
  border-radius: inherit;
  padding: 1.4px;
  background: linear-gradient(180deg,
    rgba(255,255,255,0.45) 0%, rgba(255,255,255,0.15) 20%,
    rgba(255,255,255,0)    40%, rgba(255,255,255,0)    60%,
    rgba(255,255,255,0.15) 80%, rgba(255,255,255,0.45) 100%);
  -webkit-mask: linear-gradient(#fff 0 0) content-box, linear-gradient(#fff 0 0);
  -webkit-mask-composite: xor;
          mask-composite: exclude;
  pointer-events: none;
}
.liquid-glass-strong { /* idem mas blur(50px) + box-shadow mais forte */ }

Animações — 5 primitivas (NÃO inventar novas)

  1. BlurText (títulos): word-stagger 0.07s, 0.7s duração por palavra, easing [0.22, 1, 0.36, 1]
  2. Fade-up-on-view (subtexto, CTAs): initial={{opacity:0, y:16, filter:"blur(8px)"}}, whileInView={{opacity:1, y:0, filter:"blur(0)"}}, viewport={{once:true, amount:0.3}}
  3. Scroll-scrub canvas (apenas hero): padrão Apple AirPods Pro. Ver skill scroll-scrub-canvas.
  4. Marquee (parceiros, depoimentos): 28s/32s direções opostas, máscara gradiente nas bordas, pausar ao passar o mouse
  5. Borda ::before liquid-glass (cards, pills, botões): NUNCA substituir por border CSS regular

Diretrizes anti-slop (15 regras — ler antes de submeter)

  1. NÃO usar emoji em lugar algum (nem cópia, nem cards, nem botões)
  2. NÃO usar gradientes violeta/roxo padrão (paleta é quente: ochre + terra + cream + ink)
  3. NÃO usar shadow-2xl em cards (profundidade = backdrop blur, sem sombra)
  4. NÃO usar rounded-3xl em botões → botões rounded-full, cards rounded-2xl
  5. NÃO deixar lorem ipsum como placeholder (usar [TODO: {{PLACEHOLDER}}] visível)
  6. NÃO usar text-center em parágrafos de corpo (exceto hero + CTA — são seu próprio universo)
  7. Títulos: font-display uppercase tracking-tight OU font-display italic (nunca ambos no mesmo elemento)
  8. Cada seção: padrão badge + heading + sub (exceto hero e footer)
  9. Apenas ícones lucide-react (sem heroicons, sem Material, sem SVG customizado salvo fornecido pelo usuário)
  10. NÃO usar <video> para hero — hero é canvas. <video> apenas nos fundos de Stats e CTA.
  11. NÃO usar motion.div com transition={{ duration: > 0.9 }}
  12. NÃO usar console.log, código comentado, arquivos vazios ou imports não utilizados
  13. Cópia em {{LANG}} — não traduzir placeholders automaticamente
  14. Responsivo: 1440 desktop canvas, 375px mobile (iPhone SE) sem scroll horizontal
  15. A11y: focus-visible:ring-2 ring-ring offset-2 offset-background, canvas aria-hidden, elemento sr-only irmão descreve vídeo

Verificação pré-entrega

npm run dev   # inicia sem erros
npm run build # 0 erros TS, 0 erros Vite

# Verificações visuais:
# - Hero primeira pintura < 300ms (preload priorizado frame_0001)
# - Scrub sem travamentos > 50ms
# - Marquee loop contínuo (array duplicado, ponto médio invisível)
# - FAQ accordion altura suave
# - Navbar reduz top-4→top-2 ao scroll > 40px
# - 375px sem overflow horizontal

# Console:
# - 0 avisos React
# - 0 erros 404 de URL de frame

# Perf:
# - Lighthouse Performance ≥ 85
# - LCP < 2.5s (preload frame_0001 com <link rel="preload">)

Pipeline de extração de frames

mkdir -p input public/frames

ffmpeg -i input/source.mp4 \
  -vf "fps=30,scale='min(1920,iw)':'-2':flags=lanczos" \
  -q:v 3 \
  public/frames/frame_%04d.jpg

ls public/frames | wc -l  # colar em FRAME_COUNT

WebP opcional (~40% menor):

for f in public/frames/*.jpg; do
  cwebp -q 82 "$f" -o "${f%.jpg}.webp" && rm "$f"
done

Se total > 20MB e deploy é Vercel hobby (limite 25MB): aviso + sugerir CDN externo.

Recursos

  • Componente ScrubSequence: ver skill scroll-scrub-canvas
  • Princípios de animação: skill emilkowalski-skill
  • Componentes premium: skill magic-mcp-21st
  • Documentação Tailwind v4: https://tailwindcss.com/docs/v4-beta
  • shadcn/ui: https://ui.shadcn.com
  • Framer Motion (motion.dev): skill motion

Habilidades Relacionadas