동영상 → 스크롤 구동 랜딩 페이지
Apple 제품 페이지나 GitHub Copilot 랜딩처럼 스크롤에 따라 재생되는 시네마틱 랜딩 페이지를 만듭니다. 소스 동영상에서 프레임을 추출하여 사용자가 스크롤할 때마다 프레임이 교체되며, sticky 히어로 아래에는 일반 스크롤 섹션에 카피와 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, 1030초 → 80, 3060초 → 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번 스크롤). - Sticky 히어로
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에만 해당 — 핑크 + 옐로우 + 본(bone), 순수
#fff는 사용하지 않음. - Decks 모드(Fly High 퍼플/옐로우)는 랜딩 페이지에 절대 사용하지 않음 — 해당 팔레트는 슬라이드 전용.
- 네온 모드 (YUV.AI 웹 기본값): 핫 핑크 (
- 프로젝트가 YUV.AI 브랜드가 아닌 경우: yuv-design-system을 적용하지 않음. 소스 동영상의 분위기에 맞는 팔레트를 선택. Anton + Inter는 합리적인 기본값이지만 필수는 아님.
- 히어로 오버레이는 미묘하게 — 비네트와 하나의 큰 헤드라인만; 프레임을 압도하지 않음.
- 히어로 아래 섹션: 밝은 캔버스 (네온 모드에서는 흰색, 웜 에디토리얼에서는 오프 화이트, 일반 웜에서는 본), 큰 Anton 헤딩, Inter 18~22px 본문, CTA는 날카로운 알약 모양 (
border-radius: 999px) — 네온 모드에서는 핑크 채움, 그 외 브랜드에 맞는 색상. - 히브리어: RTL 준수, 헤드라인에 Rubik 900, 본문에 Assistant 400/500 사용.
파일 참조
| 파일 | 용도 |
|---|---|
references/extract-frames.py | ffmpeg 기반 프레임 추출기; 선택적으로 전체 HTML을 한 번에 빌드 |
references/landing-template.html | 스크롤 메커니즘이 포함된 독립형 랜딩 페이지 스켈레톤 |
references/design-notes.md | 타이포그래피, 팔레트 및 모션 기본값 |