Communitygithub.com

nicolas2601/router-skills

Plantilla completa para landing premium estilo Apple/Stripe/Sony Bravia con 9 secciones tipificadas (navbar pill liquid-glass + hero scroll-scrub canvas + services bento asimétrico + why-us 4-col + process numerado + stats video bg + testimonials marquee dual + FAQ 2-col + CTA cinematic + footer). Stack obligatorio Vite + React 18 + TS + Tailwind v4 + shadcn/ui + Framer Motion + lucide-react + @fontsource. Dispara landing premium cinemática, estilo Apple, scroll-scrub video, hero canvas, landing de grado awwwards.

¿Qué es router-skills?

Este skill proporciona una plantilla prescriptiva y altamente detallada para construir landings premium de grado awwwards, inspiradas en Apple AirPods Pro, Stripe y Sony Bravia. Está diseñado para maximalistas visuales que buscan una experiencia cinematográfica con scroll-scrub en el hero (usando canvas en lugar de video), efectos liquid-glass en tarjetas y botones, animaciones de marquee dual, y una paleta de colores cálidos (ocre, terra, crema y tinta). El skill define un stack tecnológico obligatorio (Vite, React 18, TypeScript, Tailwind v4, shadcn/ui, Framer Motion, lucide-react, @fontsource) y una estructura de archivos específica con 9 secciones tipificadas (navbar, hero, services bento, pourquoi, process, stats, testimonials, FAQ, CTA+footer). Incluye reglas anti-slop muy estrictas (15 reglas) que prohíben emojis, gradientes morados, sombras, lorem ipsum, texto centrado en párrafos, y exigen tipos de letra display (Oswald) y body (Inter), así como animaciones con 5 primitivas específicas. El flujo de trabajo incluye una pipeline de extracción de frames (usando ffmpeg) para generar la secuencia de imágenes del hero, y una verificación pre-entrega con comandos `npm run dev` y `npm run build`, checklist visual, y métricas de rendimiento (Lighthouse ≥ 85, LCP < 2.5s). El skill está orientado a desarrolladores frontend que quieran crear landings de alta calidad sin desviarse de los estándares establecidos.

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

Preguntar en tu IA favorita

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

Documentación

Plantilla de Landing Cinemática

Plantilla prescriptiva para landing premium con scroll-scrub canvas hero. Inspirada en Apple AirPods Pro, Stripe, Sony Bravia.

Stack obligatorio (no sustituir)

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

Estructura de archivos

src/
  App.tsx
  main.tsx
  index.css                  # design tokens + Tailwind @theme + liquid-glass utilities
  components/
    ScrubSequence.tsx        # renderizador de frames canvas (CRÍTICO)
    BlurText.tsx             # titular palabra-por-palabra (CRÍTICO)
    Navbar.tsx               # pill flotante liquid-glass
    Hero.tsx                 # scroll-scrub canvas + titular + CTAs
    ServicesBento.tsx        # bento asimétrico de 6 tarjetas
    Pourquoi.tsx             # cuadrícula why-us de 4 columnas
    Process.tsx              # flujo horizontal numerado de 3-4 pasos
    Stats.tsx                # video bg + 4 estadísticas con count-up
    Testimonials.tsx         # 2 filas de marquee en direcciones opuestas
    Faq.tsx                  # diseño de 2 columnas (titular sticky + acordeón)
    CtaFooter.tsx            # video bg cinemático + CTA + barra de footer
    ui/
      button.tsx             # con 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

Las 9 secciones — patrones obligatorios

1. Navbar (pill flotante liquid-glass)

  • fixed top-4 left-1/2 -translate-x-1/2 z-50 con liquid-glass rounded-full px-2 py-2
  • 3 zonas: logo+marca (izquierda) | enlaces de navegación centro (md+) | CTA (derecha)
  • Scroll > 40px: top-4 → top-2 + backdrop-blur-xl
  • Móvil: hamburguesa + sheet pantalla completa liquid-glass

2. Hero (scroll-scrub canvas)

  • <section ref={scrollRef} className="relative h-[250vh]"> (250vh da scroll para secuencia de frames)
  • <div className="sticky top-0 h-screen overflow-hidden"> para pin
  • Canvas absoluto inset-0 z-0
  • Viñeta radial gradient z-1
  • Desvanecimiento inferior z-2 hacia la siguiente sección
  • Contenido (badge + BlurText H1 + sub + CTAs + marquee de partners) z-10

3. ServicesBento (asimétrico 6 tarjetas)

  • Grid md:grid-cols-3 gap-5
  • Card 0: alta row-span-2
  • Cards 1-2: pequeñas
  • Card 3: ancha col-span-2
  • Card 4: pequeña
  • Card 5: ancho completo col-span-3
  • Cada card: liquid-glass rounded-2xl + icono en liquid-glass-strong rounded-full size-11 + titular display + cuerpo 38ch + flecha ArrowUpRight arriba a la derecha

4. Pourquoi (4-col why-us)

  • Grid lg:grid-cols-4 gap-5 mt-16
  • Cada card: liquid-glass + icono + título display + cuerpo 30ch + línea de acento inferior

5. Process (numerado horizontal)

  • md:grid-cols-4 gap-0 (gap-0 porque los conectores llenan el espacio)
  • Número gigante text-[140px] text-primary/25 superpuesto
  • Conector horizontal: absolute top-20 -right-0 h-px w-full bg-gradient-to-r from-border via-border to-transparent

6. Stats (video bg + count-up)

  • Video bg filter saturate(0) desaturado
  • Desvanecimientos superior e inferior de 200px con gradient
  • Card central liquid-glass rounded-3xl p-14
  • 4 stats: valor font-display italic text-7xl + etiqueta uppercase tracking-wide text-sm
  • Animar conteo desde 0 con motion cuando entra al viewport

7. Testimonials (2 filas marquee)

  • Fila 1: animate-[marquee_28s_linear_infinite]
  • Fila 2: animate-[marquee-rev_32s_linear_infinite] (dirección opuesta)
  • Máscara: [mask-image:linear-gradient(to_right,transparent,black_8%,black_92%,transparent)]
  • Pausa al hover: hover:[animation-play-state:paused]

8. FAQ (diseño 2 columnas)

  • Grid md:grid-cols-[0.9fr_1.1fr] gap-16
  • Izquierda: sticky md:sticky md:top-24 con badge + titular display + párrafo + botón
  • Derecha: shadcn Accordion con elementos estilizados

9. CTA + Footer

  • Video bg filter brightness(0.55) (NO saturate-0 aquí, vs Stats)
  • Titular font-display italic text-[180px] (NO uppercase aquí — italic es otro estilo)
  • Footer: border-t + copyright + enlaces 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 {
  /* Raw palette HSL triplets (sin wrapper hsl() para alpha en Tailwind) */
  --ink:    20 15% 9%;
  --cream:  40 30% 90%;
  --ochre:  32 55% 65%;
  --terra:  14 55% 31%;

  /* Semántico */
  --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;

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

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

@theme {
  --color-background: hsl(var(--background));
  --color-foreground: hsl(var(--foreground));
  --color-primary: hsl(var(--primary));
  /* ... resto de 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) } }

Utilidades 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 { /* ídem pero blur(50px) + box-shadow más fuerte */ }

Animaciones — 5 primitivas (NO inventar nuevas)

  1. BlurText (titulares): palabra-por-palabra 0.07s, duración 0.7s por palabra, 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 (solo hero): patrón Apple AirPods Pro. Ver skill scroll-scrub-canvas.
  4. Marquee (partners, testimonials): 28s/32s direcciones opuestas, máscara de gradient en bordes, pausa al hover
  5. Borde ::before Liquid-glass (tarjetas, pills, botones): NUNCA reemplazar con border CSS regular

Barandillas anti-slop (15 reglas — leer antes de enviar)

  1. NO emoji en ningún lugar (ni copy, ni tarjetas, ni botones)
  2. NO gradientes violeta/púrpura por defecto (la paleta es cálida: ocre + terra + crema + tinta)
  3. NO shadow-2xl en tarjetas (la profundidad = backdrop blur, no drop shadow)
  4. NO rounded-3xl en botones → botones rounded-full, tarjetas rounded-2xl
  5. NO dejar lorem ipsum como marcador de posición (usar [TODO: {{PLACEHOLDER}}] visible)
  6. NO text-center en párrafos del cuerpo (excepto hero + CTA — son su propio mundo)
  7. Titulares: font-display uppercase tracking-tight O font-display italic (nunca ambos en el mismo elemento)
  8. Cada sección: patrón badge + titular + sub (excepto hero y footer)
  9. Solo iconos lucide-react (no heroicons, no Material, no SVG personalizado salvo que el usuario lo proporcione)
  10. NO <video> para hero — hero es canvas. <video> solo en fondos de Stats y CTA.
  11. NO motion.div con transition={{ duration: > 0.9 }}
  12. NO console.log, ni código comentado, ni archivos vacíos, ni imports no utilizados
  13. Copy en {{LANG}} — no traducir marcadores de posición automáticamente
  14. Responsive: 1440 desktop canvas, 375px móvil (iPhone SE) sin scroll horizontal
  15. A11y: focus-visible:ring-2 ring-ring offset-2 offset-background, canvas aria-hidden, sr-only sibling describe video

Verificación pre-entrega

npm run dev   # inicia sin errores
npm run build # 0 errores TS, 0 errores Vite

# Comprobaciones visuales:
# - Hero primer paint < 300ms (precargar priority frame_0001)
# - Scrub sin interrupciones > 50ms
# - Marquee loop sin costuras (duplicar array, punto medio invisible)
# - FAQ accordion altura suave
# - Navbar reduce top-4→top-2 al scroll > 40px
# - 375px sin desbordamiento horizontal

# Consola:
# - 0 advertencias React
# - 0 errores 404 de URL de frames

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

Pipeline de extracción 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  # pegar en FRAME_COUNT

WebP opcional (~40% más pequeño):

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

Si total > 20MB y el deploy es Vercel hobby (límite 25MB): advertencia + sugerir CDN externa.

Recursos

  • Componente ScrubSequence: ver skill scroll-scrub-canvas
  • Principios de animación: skill emilkowalski-skill
  • Componentes premium: skill magic-mcp-21st
  • Documentación de Tailwind v4: https://tailwindcss.com/docs/v4-beta
  • shadcn/ui: https://ui.shadcn.com
  • Framer Motion (motion.dev): skill motion

Skills relacionados