시네마틱 랜딩 템플릿
스크롤-스크럽 캔버스 히어로가 포함된 프리미엄 랜딩 페이지를 위한 규정 템플릿입니다. Apple AirPods Pro, Stripe, Sony Bravia에서 영감을 받았습니다.
고정 스택 (대체 불가)
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
파일 구조
src/
App.tsx
main.tsx
index.css # 디자인 토큰 + Tailwind @theme + liquid-glass 유틸리티
components/
ScrubSequence.tsx # 캔버스 프레임 렌더러 (핵심)
BlurText.tsx # 단어 단위 헤드라인 (핵심)
Navbar.tsx # 플로팅 리퀴드-글래스 필
Hero.tsx # 스크롤-스크럽 캔버스 + 헤드라인 + CTA
ServicesBento.tsx # 6카드 비대칭 벤토
Pourquoi.tsx # 4열 이유 제시 그리드
Process.tsx # 3-4단계 번호 매기기 가로 흐름
Stats.tsx # 비디오 배경 + 4개 통계 (카운트업)
Testimonials.tsx # 2줄 마키 반대 방향
Faq.tsx # 2열 레이아웃 (고정 제목 + 아코디언)
CtaFooter.tsx # 시네마틱 비디오 배경 + CTA + 푸터 바
ui/
button.tsx # hero, heroGlass, heroSolid 변형 포함
accordion.tsx
lib/
utils.ts
constants.ts # FRAME_COUNT, FRAMES_PATH, FRAME_EXT
public/
frames/ # frame_0001.jpg ... frame_NNNN.jpg
9개 섹션 — 필수 패턴
1. 네비게이션 바 (플로팅 리퀴드-글래스 필)
fixed top-4 left-1/2 -translate-x-1/2 z-50과 함께liquid-glass rounded-full px-2 py-2- 3개 영역: 로고+브랜드 (왼쪽) | 네비게이션 링크 중앙 (md 이상) | CTA (오른쪽)
- 스크롤 > 40px:
top-4 → top-2+backdrop-blur-xl - 모바일: 햄버거 + 전체 화면 리퀴드-글래스 시트
2. 히어로 (스크롤-스크럽 캔버스)
<section ref={scrollRef} className="relative h-[250vh]">(250vh가 프레임 시퀀스를 위한 스크롤을 제공)<div className="sticky top-0 h-screen overflow-hidden">핀 고정용- 캔버스 absolute inset-0 z-0
- 방사형 비네트 그라데이션 z-1
- 하단 페이드 z-2 (다음 섹션으로)
- 콘텐츠 (뱃지 + BlurText H1 + 서브 + CTA + 파트너 마키) z-10
3. ServicesBento (비대칭 6카드)
- 그리드
md:grid-cols-3 gap-5 - 카드 0: 높이
row-span-2 - 카드 1-2: 작은 크기
- 카드 3: 넓이
col-span-2 - 카드 4: 작은 크기
- 카드 5: 전체 너비
col-span-3 - 각 카드:
liquid-glass rounded-2xl+ 아이콘liquid-glass-strong rounded-full size-11+ 디스플레이 제목 + 본문 38ch + 오른쪽 상단 ArrowUpRight
4. Pourquoi (4열 이유 제시)
- 그리드
lg:grid-cols-4 gap-5 mt-16 - 각 카드: liquid-glass + 아이콘 + 디스플레이 제목 + 본문 30ch + 하단 악센트 라인
5. Process (번호 매기기 가로)
md:grid-cols-4 gap-0(gap-0: 커넥터가 공간을 채움)- 거대한 번호
text-[140px] text-primary/25겹침 - 가로 커넥터:
absolute top-20 -right-0 h-px w-full bg-gradient-to-r from-border via-border to-transparent
6. Stats (비디오 배경 + 카운트업)
- 비디오 배경
filter saturate(0)채도 제거 - 상단 및 하단 200px 그라데이션 페이드
- 중앙 카드 liquid-glass
rounded-3xl p-14 - 4개 통계: 값
font-display italic text-7xl+ 레이블uppercase tracking-wide text-sm - 뷰포트 진입 시 motion을 사용하여 0부터 애니메이션 카운트
7. Testimonials (2줄 마키)
- 줄 1:
animate-[marquee_28s_linear_infinite] - 줄 2:
animate-[marquee-rev_32s_linear_infinite](반대 방향) - 마스크:
[mask-image:linear-gradient(to_right,transparent,black_8%,black_92%,transparent)] - 호버 시 일시 정지:
hover:[animation-play-state:paused]
8. FAQ (2열 레이아웃)
- 그리드
md:grid-cols-[0.9fr_1.1fr] gap-16 - 왼쪽: 고정
md:sticky md:top-24+ 뱃지 + 디스플레이 제목 + 문단 + 버튼 - 오른쪽: shadcn Accordion (스타일링된 아이템)
9. CTA + 푸터
- 비디오 배경
filter brightness(0.55)(Stats와 달리 여기서는 saturate-0 사용 안 함) - 헤드라인
font-display italic text-[180px](여기서는 대문자 사용 안 함 — 이탤릭체는 다른 스타일) - 푸터: border-t + 저작권 + 푸터 링크
디자인 토큰 (index.css)
@import "@fontsource/{display-font}/400.css";
@import "@fontsource/{display-font}/700.css";
@import "@fontsource/{body-font}/400.css";
@import "tailwindcss";
:root {
/* 원시 팔레트 HSL 트리플렛 (Tailwind 알파 지원을 위해 hsl() 래퍼 없음) */
--ink: 20 15% 9%;
--cream: 40 30% 90%;
--ochre: 32 55% 65%;
--terra: 14 55% 31%;
/* 시맨틱 */
--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;
/* 타이포그래피 */
--font-display: "Oswald", "Impact", sans-serif;
--font-body: "Inter", -apple-system, sans-serif;
/* 레이아웃 */
--gutter: clamp(20px, 4.2vw, 56px);
--max: 1440px;
}
@theme {
--color-background: hsl(var(--background));
--color-foreground: hsl(var(--foreground));
--color-primary: hsl(var(--primary));
/* ... 나머지 시맨틱 토큰 */
--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) } }
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 { /* 동일하지만 blur(50px) + 더 강한 box-shadow */ }
애니메이션 — 5가지 기본 요소 (새로운 요소 추가 금지)
- BlurText (제목): 단어 간격 0.07s, 단어당 지속 시간 0.7s, easing
[0.22, 1, 0.36, 1] - Fade-up-on-view (서브텍스트, CTA):
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 (히어로 전용): Apple AirPods Pro 패턴.
scroll-scrub-canvas스킬 참조. - Marquee (파트너, testimonials): 28s/32s 반대 방향, 그라데이션 가장자리 마스크, 호버 시 일시 정지
- Liquid-glass
::before테두리 (카드, 필, 버튼): 일반 CSSborder로 절대 대체하지 않음
안티-슬롭 가드레일 (제출 전 읽을 15가지 규칙)
- 어디에도 이모지 사용 금지 (카피, 카드, 버튼 모두)
- 보라색/자주색 기본 그라데이션 금지 (팔레트는 따뜻한 색상: ochre + terra + cream + ink)
- 카드에
shadow-2xl금지 (깊이는 backdrop blur, 드롭 섀도우 아님) - 버튼에
rounded-3xl금지 → 버튼rounded-full, 카드rounded-2xl lorem ipsum플레이스홀더 남겨두지 않음 ([TODO: {{PLACEHOLDER}}]표시 사용)- 본문 문단에
text-center금지 (히어로 및 CTA 제외 — 독자적인 영역) - 제목:
font-display uppercase tracking-tight또는font-display italic(동일 요소에 둘 다 사용 금지) - 각 섹션: 뱃지 + 제목 + 서브 패턴 (히어로 및 푸터 제외)
lucide-react아이콘만 사용 (heroicons, Material, 사용자 제공이 아닌 커스텀 SVG 금지)- 히어로에
<video>사용 금지 — 히어로는 캔버스.<video>는 Stats 및 CTA 배경에만 사용. motion.div에transition={{ duration: > 0.9 }}사용 금지- console.log, 주석 처리된 코드, 빈 파일, 사용되지 않는 import 금지
{{LANG}}카피 — 플레이스홀더 자동 번역 금지- 반응형: 1440 데스크탑 캔버스, 375px 모바일 (iPhone SE) 가로 스크롤 없음
- 접근성: focus-visible:ring-2 ring-ring offset-2 offset-background, canvas aria-hidden, sr-only 형제가 비디오 설명
전달 전 확인
npm run dev # 오류 없이 시작
npm run build # 0 TS 오류, 0 Vite 오류
# 시각적 확인:
# - 히어로 첫 페인트 < 300ms (frame_0001 우선 미리 로드)
# - 스크럽 끊김 없음 > 50ms
# - 마키 루프 매끄러움 (배열 복제, 중간 지점 보이지 않음)
# - FAQ 아코디언 높이 부드럽게
# - 네비게이션 바 스크롤 > 40px 시 top-4→top-2로 줄어듦
# - 375px에서 가로 오버플로우 없음
# 콘솔:
# - 0 React 경고
# - 0 프레임 URL 404
# 성능:
# - Lighthouse Performance ≥ 85
# - LCP < 2.5s (<link rel="preload">로 frame_0001 미리 로드)
프레임 추출 파이프라인
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 # FRAME_COUNT에 붙여넣기
WebP 옵션 (~40% 더 작음):
for f in public/frames/*.jpg; do
cwebp -q 82 "$f" -o "${f%.jpg}.webp" && rm "$f"
done
총 용량이 20MB를 초과하고 배포가 Vercel Hobby 플랜(25MB 제한)인 경우: 경고 및 외부 CDN 제안.
리소스
- ScrubSequence 컴포넌트:
scroll-scrub-canvas스킬 참조 - 애니메이션 원칙:
emilkowalski-skill스킬 - 프리미엄 컴포넌트:
magic-mcp-21st스킬 - Tailwind v4 문서: https://tailwindcss.com/docs/v4-beta
- shadcn/ui: https://ui.shadcn.com
- Framer Motion (motion.dev):
motion스킬