Communitygithub.com

시네마틱 스크롤 웹 스킬

스티키 SVG/CSS 뷰포트, 스프링-러프 스크롤 물리, 반응형 SVG 필터 및 안무된 6단계 레일을 사용하여 시네마틱 스토리텔링 페이지, 대화형 만화/편집 비주얼, 스크롤 기반 제품 쇼케이스 또는 전환율이 높은 전자상거래 랜딩 페이지 등 지속적인 스크롤 연동 대화형 웹 경험을 설계하고 구축합니다.

시네마틱 스크롤 웹 스킬란 무엇인가요?

이 스킬은 단일 정규화된 스크롤 좌표(`position` ∈ [0, 1])를 공유하는 모든 시각적 레이어(카메라 줌, SVG 모핑, 입자 산란, 바람 물리, 내러티브/세일즈 카피)를 사용하여 60fps의 제로 의존성 연속 스크롤 대화형 웹 경험을 구축합니다. 스토리텔링/만화 모드와 제품 쇼케이스/전자상거래 모드를 모두 지원하며, 스티키 뷰포트, 스프링-러프 애니메이션 루프, 6단계 챕터 아크, 반응형 SVG 필터를 핵심 아키텍처로 사용합니다. Claude Code, Cursor, Codex 등 모든 코드 작성 AI 에이전트가 이 지침을 따라 개발자가 직접 전체 페이지를 제작하거나 템플릿을 확장할 수 있습니다. 또한 SVG 및 CSS의 일반적인 함정(예: CSS opacity가 SVG 속성을 재정의하는 문제, transform-origin 무시, 화면 중간 대기 누락 등)을 방지하는 방법을 상세히 설명하여 안정적이고 시각적으로 일관된 결과를 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

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

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

문서

시네마틱 스크롤 연동 웹 스킬

카메라 줌, SVG 모핑, 입자 산란, 바람 물리, 내러티브/세일즈 카피 등 모든 시각적 레이어가 단일 정규화된 스크롤 좌표(position ∈ [0, 1])를 공유하는, 제로 의존성 60fps 연속 스크롤 대화형 웹 경험을 구축합니다.

아키텍처 개요

모든 페이지는 긴 스크롤 트랙 내부에 4개의 레이어로 구성된 스티키 단계를 따릅니다:

#track (높이: 700vh, 자연스러운 스크롤 거리 생성)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
    ├── #sky / 주변 배경 레이어 (색상 및 무드 보간)
    ├── #world (격리된 무대: 히로 중앙 요소, SVG 필터, 입자, 분위기)
    ├── #rail (position: absolute; N개의 쌓인 100vh 챕터가 연속적으로 이동)
    └── #texture / HUD (#bar, #meter, #guide, 전자상거래용 스티키 CTA 바)
  • 클래스만으로 개별 슬라이드를 토글하지 마십시오. #rail을 translate3d(0, ${-position * (N - 1) * innerHeight}px, 0)로 구동하고 모든 장면 전환을 smooth(a, b, position)(smoothstep)으로 보간합니다.
  • 명시적 상호작용 요소(#overlay button, 변형 견본, 구매/장바구니 CTA)를 제외하고 #world와 #rail을 비차단(pointer-events: none)으로 유지하십시오. 이러한 요소는 pointer-events: auto와 더 높은 z-index를 설정해야 합니다.

빌드 워크플로우

  1. 도메인 모드 선택:
  2. 계층형 히어로 SVG 설계:
    • 단일 정규화된 viewBox 안에 이름이 지정된 <g> 레이어를 사용하여 히로 중앙 요소(캐릭터, 엠블럼 또는 제품 하드웨어)를 구축하여 개별 하위 부분이 독립적으로 회전, 분해, 확대/축소 또는 색상 변경이 가능하도록 합니다.
  3. 스프링-러프 루프(requestAnimationFrame) 연결:
    • target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1)을 계산합니다.
    • position += (target - position) * 0.115로 부드럽게 하고 파생된 speed와 제한된 impulse(wind)를 계산하여 빠른 스크롤이 천, 머리카락, 입자 및 SVG 변위 필터를 자연스럽게 구동하도록 합니다.
  4. 6단계 아크 안무:
    • 0.00에서 1.00까지 6개의 균등하게 간격이 있는 100vh .chapter 섹션(top: 0 ~ top: 500vh)에 매핑합니다.
    • 점진적인 확대/축소(scale) 및 레이어 크로스페이드(smooth(a, b, position))를 간결한 .caption 카드 및 상단 #bar + #meter HUD와 쌍으로 구성합니다.
  5. 배송 전 확인:
    • 로컬 HTTP로 제공하고 00%, 25%, 50%, 75%, 100% 스크롤 위치에서 테스트합니다.
    • 대화형 오버레이(#enter), 변형 선택기 및 스티키 CTA가 클릭 가능한지(pointer-events: auto) 확인합니다.
    • 콘솔 오류가 없고, 밝은 초점 요소에서 텍스트 대비가 읽기 쉬우며, 데스크톱(1280x800) 및 모바일(390x844) 뷰포트에서 깔끔하게 프레이밍되는지 확인합니다.

중요한 SVG 및 CSS 함정

SVG가 많은 스크롤 페이지를 구축할 때 다음과 같은 일반적인 오류를 피하십시오:

  1. CSS #id { opacity: 0 }가 setAttribute('opacity', ...)를 차단합니다: ID 선택자는 CSS에서 SVG 프레젠테이션 속성을 재정의합니다. CSS에서 opacity: 0을 생략하고 (처음에 opacity="0" SVG 속성 + setAttribute('opacity', ...) 사용)하거나 JS에서 el.style.opacity를 업데이트하십시오.
  2. SVG transform 속성은 CSS transform-origin을 무시합니다: transform-box: fill-box; transform-origin: ...은 CSS el.style.transform에만 적용됩니다. SVG setAttribute('transform', ...)의 경우 중심 (cx, cy) 주변의 회전/크기 조정을 명시적으로 래핑하십시오: translate(cx cy) rotate(deg) scale(s) translate(-cx -cy).
  3. 뾰족한 쐐기 대신 3차 베지어 곡선(C) 사용: 유기적인 머리카락, 리본, 천, 연기 또는 액체 자취의 경우 삼각형 L 스파이크와 큰 CSS skewX 왜곡을 피하십시오. phase와 제한된 wind를 따라 사인파 오프셋으로 3차 베지어 제어점을 부드럽게 애니메이션합니다.
  4. 히어로 래퍼 종횡비를 viewBox에 고정: 독립적인 vw와 vh 차원을 혼합하는 대신 히어로 SVG 컨테이너에 aspect-ratio: <W>/<H>; height: auto;를 지정하여 transform-origin 확대/축소 좌표가 모든 화면 크기에서 대상에 고정되도록 합니다.
  5. 화면 중간 대기 누락 방지: 보이는 획으로 평평한 수평선(L1440 490 ... Z)을 따라 화면 중간 안개/연기 <path> 모양을 닫지 마십시오. stroke: none을 사용하고 구름 띠를 뷰포트 아래에서 부드럽게 닫거나 바닥 곡선이 물결치는 형태로 만듭니다.
  6. 발광 초점 영역 위의 텍스트 대비 보호: 큰 디스플레이 제목에 계층화된 어두운 드롭 섀도우(text-shadow)를 적용하고 캡션에 어두운 반투명 카드(backdrop-filter: blur(4px))를 적용하여 밝은 달, 광채 또는 금속성 제품 하이라이트 위를 지나갈 때도 카피가 읽기 쉽도록 합니다.

참조 및 예제

  • 물리 및 SVG 엔진 — 스프링-러프 수학, smooth(), 반응형 SVG 필터, 동심 회전, 이동 베지어 파동 및 입자 산란 공식.
  • 전자상거래 적응 가이드 — 6챕터 아크를 제품 출시, 분해 보기, 색상 변경, 사양 콜아웃 및 스티키 구매 바에 적응.
  • 시작 템플릿 — 모든 테마에 준비된 깔끔한 6단계 연속 스크롤 스캐폴드.
  • 전자상거래 제품 쇼케이스 — 이 엔진으로 구축된 전체 작동 럭셔리 시계/하드웨어 제품 출시 데모.

관련 스킬