시네마틱 스크러브 랜딩 페이지 — The Golden Template
히어로 비디오가 마우스에 반응하고 나머지 페이지는 5박자 내러티브 아크를 따라 사용자를 안내하는 프리미엄 브랜드 인지 랜딩 페이지를 구축합니다. 사용자가 비디오와 선택적으로 로고 + 제품 사진 + 브랜드 컨텍스트를 제공하면, 이 스킬이 팔레트 추출, 타이포그래피 선택, RTL/LTR, 스캐폴딩, 모든 키프레임 비디오 재인코딩, 마우스 스크러빙 효과, 섹션 라이브러리 및 검증을 처리합니다.
이 스킬이 존재하는 이유
참조 구현은 https://github.com/hoodini/bamba에 있습니다 — 이스라엘 RTL 사이트로, 간식 "במבה"를 위한 사이트입니다. 이 사이트에서는 아기 비디오가 페이지 전체에서 커서를 추적하고, 아래 4개의 개별 섹션(밝은 노란색 레시피, 크림 향수 앨범, 어두운 가격 책정, 빨간 액션 피날레)이 갈망 → 기쁨 → 향수 → 성찰 → 행동을 따라 사용자를 안내합니다.

이 스킬의 모든 규칙은 그 빌드에서 추출되었습니다. 하드 룰 섹션의 글머리 기호는 모두 어렵게 얻은 것입니다 — 이는 일반적인 "좋은 코드" 기본값을 덮어씁니다.
섹션 갤러리 (당신이 구축할 것)
히어로가 맨 위에 있습니다. 그 아래에서 라이브러리에서 4개의 섹션을 선택하여 내러티브 아크를 따르도록 정렬합니다. 각 섹션은 완전히 불투명(비디오가 비치지 않음)하고 고유한 브랜드 아이덴티티를 가집니다:
| 비트 | 유형 | 참조 |
|---|---|---|
| 1 — 갈망 | 히어로 (마우스 스크러빙 비디오) | ![]() |
| 2 — 기쁨 | 태양 — 밝은 기본-강조 그라디언트, 떠다니는 모티프 SVG, 거대한 고스트 타이포그래피, 통계 카드 | ![]() |
| 3 — 향수 | 앨범 — 크림 종이, 점선 미세 패턴, 실제 제품 사진이 있는 폴라로이드 벤토 | ![]() |
| 4 — 성찰 | 로스트 — 어둡고 방사형 강조 광선, 각각 다른 시각적 처리가 있는 세 개의 가격 카드 | ![]() |
| 5 — 행동 | 신호 — 전체 블리드 강한 강조(빨강/주황/초록), 거대한 헤드라인 + CTA, 유리로 감싼 패널 | ![]() |
기술/SaaS 브랜드의 경우 필요에 따라 섹션 유형을 교체합니다(아래 섹션 라이브러리 참조) — 하지만 항상 Signal 섹션으로 끝내야 합니다.
이 스킬 사용 방법
-
에셋을 깨끗한 작업 디렉토리에 넣습니다:
- 히어로 비디오 (모든 컨테이너 —
.mp4,.mov,.webm) - 로고 (SVG 강력 권장; 투명도 있는 PNG도 허용)
- 1-3개의 제품/주제 이미지 (JPG/PNG, 투명이 이상적)
- 히어로 비디오 (모든 컨테이너 —
-
사용자와 확인(간략히 — 기본값 제안 후 진행):
- 제품 이름 + 메타 태그라인
- 언어 코드 (RTL/LTR + 글꼴 선택 결정)
- 브랜드 컨텍스트 — 시대, 타겟, 감정적 핵심, 팔레트 느낌
- 선택 사항: 명시적 팔레트 16진수, 내러티브 아크 비트
-
아래 워크플로를 순서대로 실행합니다. 모든 단계는 필수입니다. ffmpeg 재인코딩을 건너뛰지 마세요 — 그것이 스크러빙을 부드럽게 만드는 마법입니다.
-
완료되었다고 보고하기 전에 확인합니다. 9단계에는 12개의 검사가 있습니다. 모두 실행합니다.
입력 — 사용자로부터 수집
PRODUCT_NAME: "<예: במבה / Bamba / Hope the Cheetah / Acme CRM>"
TAGLINE: "<메타 메시지 — 예: '그것은 간식이 아니라, 평생의 추억입니다'>"
LANGUAGE: "<he | en | ar | es | fr | ja | ...>"
IS_RTL: "<true | false>" # he/ar/fa = true; 그 외는 모두 false
HERO_VIDEO_FILE: "<현재 작업 디렉토리의 정확한 파일명 — 예: baby2.mp4>"
LOGO_FILE: "<정확한 파일명 — 없으면 비워둠>"
PRODUCT_IMAGE_FILE: "<정확한 파일명 — 없으면 비워둠>"
BRAND_CONTEXT: |
<2-4문장: 불러일으키는 시대, 타겟 대상, 감정적 핵심,
시각적 아이덴티티(따뜻함/차가움/장난기/진지함). 팔레트 + 모티프 결정.>
PALETTE: "<선택 사항 — 덮어쓸 쉼표로 구분된 16진수>"
NARRATIVE_ARC: "<선택 사항 — 5가지 감정 비트; 비어 있으면 AI가 제안>"
전체 텍스트 템플릿(동일한 YAML 블록 및 프롬프트 본문 포함)은 references/GOLDEN_PROMPT.md에 있습니다 — 스킬 런타임에 직접 액세스할 수 없을 때 YAML을 채워 Claude에 붙여넣으세요.
0단계 — 디자인 계획 (코딩 전에 200단어 이하 브리핑 출력)
코드를 작성하기 전에 다음을 출력합니다:
-
추출된 5색 팔레트:
background(가장 진한 잉크),cream(따뜻한 오프화이트 텍스트 — 절대#FFFFFF안 됨),accent(기본 브랜드 색상),accent2(보조 브랜드 색상),support(3차 톤).PALETTE가 제공되지 않은 경우 로고 + 제품 이미지에서 추출합니다. 팔레트는 내부적으로 응집력 있어야 합니다 — 모두 따뜻하거나 모두 차가워야 하며, 절대 혼합되지 않습니다. 따뜻한 브랜드(음식, 자연, 향수, 동물) → 파랑, 청록, 민트, 시안 없음. 차가운 브랜드(기술, 금융, 의료, SF) → 작은 강조를 제외한 따뜻한 톤 없음. -
타이포그래피 3종 세트 (표시/본문/손글씨-강조) 언어별:
he: Rubik (표시) + Assistant (본문) + Suez One (강조)en: Anton (표시) + Inter (본문) + Caveat (강조)ar: Cairo (표시) + Tajawal (본문) + Reem Kufi (강조)es/fr/it/de: Anton 또는 Bebas Neue (표시) + Inter (본문) + Caveat (강조)ja: Noto Sans JP weight 900 (표시) + Noto Sans JP (본문) + Yusei Magic (강조)- 기타: 대본과 일치하는 3개의 Google Fonts를 선택하며, 동일한
display-black / body-clean / handwritten-script역할을 수행합니다.
-
내러티브 아크 —
BRAND_CONTEXT에 매핑되는 5가지 감정 비트. 각각을 섹션 라이브러리의 섹션 유형과 일치시킵니다.
그런 다음 실행합니다 — 확인을 요청하지 마세요.
1단계 — 에셋 준비 (마법 단계)
1a. ffmpeg 확인
which ffmpeg # 또는: PowerShell에서 Get-Command ffmpeg
없으면 중단하고 사용자에게 설치하라고 알립니다 (brew install ffmpeg / Windows: http://ffmpeg.org).
1b. 모든 프레임을 키프레임으로 히어로 비디오 재인코딩
브라우저는 키프레임으로만 즉시 탐색할 수 있습니다 — 표준 비디오는 약 250프레임당 1개의 키프레임이 있어 마우스 스크러빙이 심하게 끊깁니다. 이 단일 명령이 아마추어와 프리미엄을 구분합니다:
ffmpeg -y -i <HERO_VIDEO_FILE> -g 1 -keyint_min 1 -c:v libx264 -preset slow -crf 20 -pix_fmt yuv420p -an hero.mp4
출력을 확인합니다: hero.mp4는 5-50MB여야 합니다. 50MB를 초과하면 -crf 25로 재실행하고, 80MB를 초과하면 -crf 28로 재실행합니다. 오디오 제거(-an) — 히어로는 무음입니다.
1c. 로고 + 제품 이미지 복사
cp <LOGO_FILE> public/logo.<ext>
cp <PRODUCT_IMAGE_FILE> public/product.<ext> # 제공된 경우
2단계 — 스캐폴딩
npm create vite@latest site -- --template react-ts
cd site
npm install
npm install lucide-react
npm install -D tailwindcss@3 postcss autoprefixer
npx tailwindcss init -p
mkdir -p public
mv ../hero.mp4 public/hero.mp4
# 또한 로고 + 제품 이미지를 public/으로 이동
3단계 — Tailwind 설정
tailwind.config.js를 완전히 교체합니다. 추출된 팔레트와 언어에 맞는 글꼴을 사용합니다:
/** @type {import('tailwindcss').Config} */
export default {
content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
theme: {
extend: {
colors: {
background: '<잉크/어두운 색>',
cream: '<따뜻한 오프화이트 — 절대 #FFFFFF 아님>',
accent: '<기본 브랜드 색상>',
accent2: '<보조>',
support: '<3차>',
},
fontFamily: {
sans: ['<본문 글꼴>', 'system-ui', 'sans-serif'],
display: ['<표시 글꼴>', 'sans-serif'],
accent: ['"<손글씨 글꼴>"', 'cursive'],
},
},
},
plugins: [],
}
4단계 — index.html
완전히 교체합니다. IS_RTL을 존중합니다. 항상 로고를 가리키는 파비콘 링크를 포함합니다:
<!DOCTYPE html>
<html lang="<LANGUAGE>" dir="<rtl|ltr>">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/logo.svg" />
<link rel="apple-touch-icon" href="/logo.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="<선택한 세 글꼴의 Google Fonts URL>" rel="stylesheet">
<title><PRODUCT_NAME> — <TAGLINE></title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
5단계 — index.css (디자인 시스템)
완전히 교체합니다. 아래 모든 유틸리티는 필수입니다. 이름은 이전에 추출한 따뜻한 팔레트를 가정합니다. 차가운 브랜드의 경우 그림자 색조의 "노란색"/"빨간색" 언급을 실제 강조 색상으로 바꿉니다.
다음을 포함해야 합니다:
html { scroll-behavior: smooth; }+section[id] { scroll-margin-top: 90px; }— 앵커가 지정된 섹션이 고정된 내비게이션 아래로 떨어지지 않도록 합니다.body배경 =background색상(비디오 실패 시 대비). 커서 =crosshair. 기본 글꼴 = 본문 산세리프..liquid-glass/.liquid-glass-strong— backdrop-blur + saturate + 내부 조명 테두리 + 마스킹된 그라디언트 가장자리 하이라이트. 강한 변형은accent로 색조가 입혀진 내부 광선을 사용합니다..glass-pill— 내비게이션 항목과 작은 배지를 위한 동일한 유리 처리의 컴팩트한 둥근 알약..cta-primary— 브랜드 CTA:linear-gradient(135deg, accent-light, accent, accent-shade)+ 호버 시 강화되고translateY(-1px)리프트가 있는 강조색 글로우 그림자..brand-mark— SVG가 제공되지 않은 경우 작은 로고 마크용 작은 정사각형/원..grid-bg— 방사형 페이드 마스크가 있는 미묘한 1px 그리드, 어두운 섹션 아래에서 사용..reveal/.revealed— IntersectionObserver 스크롤 리빌:opacity 0 → 1+translateY 28 → 0over 0.9s withcubic-bezier(0.16, 1, 0.3, 1)..scrim-top/.scrim-bottom— 히어로 전용 그라디언트 오버레이.- 섹션별 배경, 색상이 아닌 느낌으로 이름 지정:
.sun-section— 밝은 기본-강조 그라디언트 + 미묘한 점선 텍스처("기쁨 / 봉지 여는" 비트)..album-section— 따뜻한 오프화이트 종이, 방사형 강조 색조 + 점선 마이크로 패턴, 가장자리 마스크 페이드..roast-section— 반대쪽 모서리에 방사형 강조 + accent2 광선 + 마스킹된 그리드 텍스처가 있는 어두운 배경..signal-section— 액션 피날레를 위한 전체 블리드 강한 강조(종종 빨강/주황/초록).
.polaroid— 흰색 카드, 패딩14px 14px 44px 14px, 부드러운 레이어 그림자, 호버 시translateY(-6px) rotate(0)으로 리프트..polaroid-tape= 맨 위 중앙에 절대 위치, -4° 회전, 점선 측면 힌트가 있는 노란색/강조 테이프 스트립..stamp— 강조 색상의 점선 테두리 알약, 대문자, 자간0.18em..ribbon—clip-path삼각형 하단, 어두운 드롭 그림자가 있는 가격/인기 배지..highlight-circle—::after를 통해 그려진 손으로 그린 느낌의 타원: 인라인<span>주위에 3px 회전된 강조색 테두리. 큰 제목에서 가장 중요한 단어 하나 주위에 사용합니다(제목당 최대 1개).- 장식 모티프 필터:
.peanut-svg/.<motif>-svgwithdrop-shadow. prefers-reduced-motion: reduce를 존중합니다 — 미디어 쿼리 내에서 리빌 애니메이션 + 부드러운 스크롤을 비활성화합니다.
6단계 — App.tsx 아키텍처
아키텍처는 협상할 수 없습니다. 처음에 올바르게 만듭니다:
6a. Imports
import { useEffect, useRef, useState } from 'react';
import {
Menu, X, ArrowLeft, ArrowRight, ArrowDown, ArrowUp, MousePointer2,
// …그 외 4-8개의 브랜드 테마 아이콘 (Heart, Sparkles, Cookie, PawPrint, Cpu, Leaf, …)
} from 'lucide-react';
6b. App.tsx 내부에 정의된 재사용 가능한 컴포넌트
useReveal<T>()— ref를 반환하는 IntersectionObserver 훅; 첫 번째 교차 시(임계값 0.15)revealed클래스를 추가합니다.GlassCard— 리빌 훅, 선택적strongprop, className을 허용하는 래퍼.Motif—BRAND_CONTEXT에 맞춰 테마가 지정된 단일 장식 SVG 컴포넌트 (음식용 땅콩, 동물용 발, 기술용 회로, 자연용 잎, 음료용 물방울, 에너지용 번개). 어두운/밝은 섹션당 3-6곳에 낮은 불투명도로 떠 있습니다.ScrollToTopButton— RTL에서는bottom-6 left-6/ LTR에서는bottom-6 right-6에 고정.window.scrollY > window.innerHeight * 0.6일 때 나타납니다. 맨 위로 부드럽게 스크롤됩니다. 짧은 언어에 맞는 레이블("לראש" / "Top" / "أعلى" / "Inicio").
6c. 마우스 스크러빙 효과 (핵심)
const videoRef = useRef<HTMLVideoElement>(null);
const stateRef = useRef({ targetTime: 0, isSeeking: false });
useEffect(() => {
const video = videoRef.current;
if (!video) return;
const handleLoaded = () => {
const mid = video.duration / 2;
video.currentTime = mid;
stateRef.current.targetTime = mid;
};
const handleSeeked = () => {
const s = stateRef.current;
s.isSeeking = false;
if (Math.abs(s.targetTime - video.currentTime) > 0.01) {
s.isSeeking = true;
video.currentTime = s.targetTime;
}
};
const handleMouseMove = (e: MouseEvent) => {
const s = stateRef.current;
const d = video.duration;
if (!d || isNaN(d)) return;
const normalized = e.clientX / window.innerWidth;
// 만약 주제가 커서를 기준으로 "뒤로" 움직이는 느낌이 들고 부자연스럽다면,
// 선택적으로 `1 - (e.clientX / window.innerWidth)`를 대신 사용할 수 있습니다 — 먼저 사용자에게 물어보세요.
s.targetTime = Math.max(0, Math.min(d, normalized * d));
if (!s.isSeeking) { s.isSeeking = true; video.currentTime = s.targetTime; }
};
video.addEventListener('loadedmetadata', handleLoaded);
video.addEventListener('seeked', handleSeeked);
window.addEventListener('mousemove', handleMouseMove);
return () => {
video.removeEventListener('loadedmetadata', handleLoaded);
video.removeEventListener('seeked', handleSeeked);
window.removeEventListener('mousemove', handleMouseMove);
};
}, []);
isSeeking 가드는 매우 중요합니다 — 이것이 없으면 mousemove가 브라우저가 디코딩할 수 있는 것보다 빠르게 실행되어 seek-queue 오버플로와 눈에 띄는 끊김이 발생합니다.
6d. 클릭 가능한 스크롤 스파이 내비게이션
const navItems: { label: string; target: string }[] = [
{ label: '<demo>', target: 'top' },
{ label: '<recipe>', target:
...
[truncated]








