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-50conliquid-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 enliquid-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/25superpuesto - 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+ etiquetauppercase 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-24con 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)
- BlurText (titulares): palabra-por-palabra 0.07s, duración 0.7s por palabra, easing
[0.22, 1, 0.36, 1] - 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}} - Scroll-scrub canvas (solo hero): patrón Apple AirPods Pro. Ver skill
scroll-scrub-canvas. - Marquee (partners, testimonials): 28s/32s direcciones opuestas, máscara de gradient en bordes, pausa al hover
- Borde
::beforeLiquid-glass (tarjetas, pills, botones): NUNCA reemplazar con border CSS regular
Barandillas anti-slop (15 reglas — leer antes de enviar)
- NO emoji en ningún lugar (ni copy, ni tarjetas, ni botones)
- NO gradientes violeta/púrpura por defecto (la paleta es cálida: ocre + terra + crema + tinta)
- NO
shadow-2xlen tarjetas (la profundidad = backdrop blur, no drop shadow) - NO
rounded-3xlen botones → botonesrounded-full, tarjetasrounded-2xl - NO dejar
lorem ipsumcomo marcador de posición (usar[TODO: {{PLACEHOLDER}}]visible) - NO
text-centeren párrafos del cuerpo (excepto hero + CTA — son su propio mundo) - Titulares:
font-display uppercase tracking-tightOfont-display italic(nunca ambos en el mismo elemento) - Cada sección: patrón badge + titular + sub (excepto hero y footer)
- Solo iconos
lucide-react(no heroicons, no Material, no SVG personalizado salvo que el usuario lo proporcione) - NO
<video>para hero — hero es canvas.<video>solo en fondos de Stats y CTA. - NO
motion.divcontransition={{ duration: > 0.9 }} - NO console.log, ni código comentado, ni archivos vacíos, ni imports no utilizados
- Copy en
{{LANG}}— no traducir marcadores de posición automáticamente - Responsive: 1440 desktop canvas, 375px móvil (iPhone SE) sin scroll horizontal
- 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