비디오 → 스크롤 기반 랜딩 페이지은(는) 무엇을 하나요?
비디오가 시간이 아닌 스크롤에 따라 재생되는 시네마틱 랜딩 페이지를 구축합니다. Apple 제품 페이지나 GitHub Copilot 랜딩과 유사합니다. 소스 비디오에서 프레임을 추출하여 사용자가 스크롤할 때 전환되며, 고정 히어로 아래에는 일반 스크롤 섹션에 카피와 CTA가 배치됩니다.
호출 시점
- 사용자가 비디오를 제공하고 랜딩 페이지, 스크롤 사이트, 스크롤 프레임 히어로, 또는 비디오로 만든 웹사이트를 요청할 때
- "Apple 스타일 스크롤", "GitHub Copilot 랜딩", "스크롤 시 프레임 전환", "스크롤 기반 비디오" 등의 언급이 있을 때
- 히브리어 동등 표현: "דף נחיתה מסרטון", "אתר עם גלילה", "סרטון בגלילה"
저장 위치
기본값: ~/Documents/yuv-projects/landings/<slug>/ — 항상 랜딩 페이지를 여기에 저장하여 나중에 다시 찾을 수 있도록 합니다. 상위 디렉토리가 없으면 생성합니다.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 여기에 <slug>/를 빌드합니다.
최종 경로: ~/Documents/yuv-projects/landings/<slug>/. 빌드가 끝날 때마다 사용자에게 랜딩 페이지 위치를 알려줍니다.
워크플로우 (8단계)
- 소스 분석 —
ffprobe로 재생 시간, FPS, 해상도, 오디오 정보를 확인합니다. - 프레임 개수 선택 — 기본
80. 하한40(더 낮으면 끊김), 상한160(페이지가 무거워짐). 재생 시간 기준: ≤10초 → 50, 10–30초 → 80, 30–60초 → 120, >60초 → 160. - 출력 디렉토리 결정 — 기본값
~/Documents/yuv-projects/landings/<slug>/.<slug>는 비디오 이름이나 주제에서 파생된 짧은 식별자입니다. 명시적 요청이 있을 때만 재정의합니다. - 프레임 추출 —
references/extract-frames.py <source-video> <output-dir> [count]실행.output-dir/frames/f_0001.jpg... 형식으로 일관된 JPG 품질 82, 최대 너비 1920px(소스가 더 큰 경우 다운스케일)로 출력합니다. references/landing-template.html복사 및 사용자 정의하여output-dir/index.html에 저장:__FRAMES__플레이스홀더를 각 프레임의<img>태그로 교체합니다(빌드 스크립트가--build-html플래그를 전달하면 자동으로 수행).__HEADLINE__,__TAGLINE__,__CTA_TEXT__,__CTA_HREF__, 섹션을 채웁니다.- 히브리어 콘텐츠의 경우:
<html lang="he" dir="rtl">로 설정하고 폰트를 Rubik/Assistant로 변경합니다(references/design-notes.md참조).
- 프레임 최적화 — 빌드 스크립트가 이미 최대 1920px로 스케일링합니다. 페이지 총 용량이 12MB를 초과하면 품질을 75로 낮추거나 프레임 개수를 줄입니다.
- 미리보기 — 출력 디렉토리 내에서
python -m http.server를 실행하고http://localhost:8000을 엽니다. 적당한 성능의 머신에서 부드러운 스크롤을 확인합니다. - 배포 — 폴더를 Vercel/Netlify/Cloudflare Pages에 드롭합니다. 별도의 빌드 단계가 필요 없습니다.
스크롤 메커니즘
- 외부 스크롤러
.scroll-stage의 높이는 뷰포트 단위로 설정됩니다(기본600vh= 모든 프레임을 순회하려면 5화면 스크롤). - 고정 히어로:
position: sticky; top: 0; height: 100vh, 모든 프레임을 절대 위치로 배치하고 활성 프레임 외에는 숨깁니다. - 스크롤 리스너가
progress = scrolledIntoStage / scrollableHeight를 계산하고 0–1 범위로 제한합니다. idx = floor(progress * (N - 1))— 해당 프레임에.active클래스를 전환합니다.- 리스너를
requestAnimationFrame으로 래핑하여 60fps를 유지합니다.
디자인 규칙
- 프로젝트가 YUV.AI 브랜드(Yuval 개인, 그의 포트폴리오, 그의 브랜드)인 경우:
yuv-design-system을 호출하고 매체에 따라 모드를 고정합니다.- 네온 모드(YUV.AI 웹의 기본값): 핫 핑크(
#FF1464) + 네온 시안(#00E5FF) + 흰색 또는 진한 검정 배경. Anton + Inter(영어) / Rubik + Assistant(히브리어). 0px 또는 999px 모서리 둥글기. - 웜 에디토리얼 모드: Hope, Marcus, bigcats.ai, practical.yuv.ai 전용 — 핑크 + 노랑 + 본, 순수
#fff가 아닌 오프화이트. - 랜딩 페이지에 Decks 모드(Fly High 보라/노랑)를 절대 사용하지 마세요 — 해당 팔레트는 슬라이드 덱 전용입니다.
- 네온 모드(YUV.AI 웹의 기본값): 핫 핑크(
- 프로젝트가 YUV.AI 브랜드가 아닌 경우: yuv-design-system을 적용하지 마십시오. 소스 비디오 분위기에 맞는 팔레트를 선택하세요. Anton + Inter는 합리적인 기본값이지만 필수는 아닙니다.
- 히어로 오버레이는 미묘하게 — 비네트와 하나의 큰 헤드라인만; 프레임을 가리지 않도록 합니다.
- 히어로 아래 섹션: 밝은 캔버스(네온 모드에서는 흰색, 웜 에디토리얼 모드에서는 오프화이트, 일반 웜 분위기에서는 본), 큰 Anton 헤드라인, 18–22px의 Inter 본문, 날카로운 알약 모양(
border-radius: 999px)의 CTA — 네온 모드에서는 핑크 채움, 그 외에는 브랜드에 적합한 색상. - 히브리어의 경우: RTL을 존중하고, 헤드라인에는 Rubik 900, 본문에는 Assistant 400/500을 사용합니다.
파일 참조
| 파일 | 목적 |
|---|---|
references/extract-frames.py | ffmpeg 기반 프레임 추출기; 선택적으로 전체 HTML을 한 번에 빌드 |
references/landing-template.html | 스크롤 메커니즘이 포함된 자체 완결형 랜딩 페이지 스켈레톤 |
references/design-notes.md | 타이포그래피, 팔레트 및 모션 기본값 |