Communitygithub.com

nicolas2601/router-skills

Apple/Stripe/Sony Bravia 스타일 프리미엄 랜딩 페이지를 위한 전체 템플릿. 9개 섹션, Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion 스택 기반.

router-skills란 무엇인가요?

이 스킬은 Apple AirPods Pro, Stripe, Sony Bravia 웹사이트에서 영감을 받은 시네마틱 프리미엄 랜딩 페이지 템플릿을 생성합니다. Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion의 고정 스택을 사용하며, 9개의 필수 섹션(네비게이션 바, 스크롤-스크럽 캔버스 히어로, 비대칭 벤토 서비스, 4열 이유 제시, 번호가 매겨진 프로세스, 비디오 배경 통계, 이중 마키 testimonials, 2열 FAQ, 시네마틱 CTA + 푸터)을 포함합니다. 특히 `liquid-glass` CSS 유틸리티를 통한 유리질 효과, `BlurText` 단어 단위 애니메이션, `Scroll-scrub canvas`를 통한 Apple 스타일의 프레임 기반 인터랙션, 마키 애니메이션, 비디오 배경 등의 고급 시각적 요소를 구현합니다. 또한 15개의 '안티-슬롭' 가드레일을 제공하여 일관된 고품질 결과를 보장하며, 성능 최적화(프레임 사전 로딩, Lighthouse 85 이상) 및 프레임 추출 파이프라인(ffmpeg)을 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nicolas2601/router-skills/tree/HEAD/skills/cinematic-landing-template

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

시네마틱 랜딩 템플릿

스크롤-스크럽 캔버스 히어로가 포함된 프리미엄 랜딩 페이지를 위한 규정 템플릿입니다. 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가지 기본 요소 (새로운 요소 추가 금지)

  1. BlurText (제목): 단어 간격 0.07s, 단어당 지속 시간 0.7s, easing [0.22, 1, 0.36, 1]
  2. 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}}
  3. Scroll-scrub canvas (히어로 전용): Apple AirPods Pro 패턴. scroll-scrub-canvas 스킬 참조.
  4. Marquee (파트너, testimonials): 28s/32s 반대 방향, 그라데이션 가장자리 마스크, 호버 시 일시 정지
  5. Liquid-glass ::before 테두리 (카드, 필, 버튼): 일반 CSS border로 절대 대체하지 않음

안티-슬롭 가드레일 (제출 전 읽을 15가지 규칙)

  1. 어디에도 이모지 사용 금지 (카피, 카드, 버튼 모두)
  2. 보라색/자주색 기본 그라데이션 금지 (팔레트는 따뜻한 색상: ochre + terra + cream + ink)
  3. 카드에 shadow-2xl 금지 (깊이는 backdrop blur, 드롭 섀도우 아님)
  4. 버튼에 rounded-3xl 금지 → 버튼 rounded-full, 카드 rounded-2xl
  5. lorem ipsum 플레이스홀더 남겨두지 않음 ([TODO: {{PLACEHOLDER}}] 표시 사용)
  6. 본문 문단에 text-center 금지 (히어로 및 CTA 제외 — 독자적인 영역)
  7. 제목: font-display uppercase tracking-tight 또는 font-display italic (동일 요소에 둘 다 사용 금지)
  8. 각 섹션: 뱃지 + 제목 + 서브 패턴 (히어로 및 푸터 제외)
  9. lucide-react 아이콘만 사용 (heroicons, Material, 사용자 제공이 아닌 커스텀 SVG 금지)
  10. 히어로에 <video> 사용 금지 — 히어로는 캔버스. <video>는 Stats 및 CTA 배경에만 사용.
  11. motion.div에 transition={{ duration: > 0.9 }} 사용 금지
  12. console.log, 주석 처리된 코드, 빈 파일, 사용되지 않는 import 금지
  13. {{LANG}} 카피 — 플레이스홀더 자동 번역 금지
  14. 반응형: 1440 데스크탑 캔버스, 375px 모바일 (iPhone SE) 가로 스크롤 없음
  15. 접근성: 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 스킬

관련 스킬