Communitygithub.com

랜딩 페이지 슬라이더

랜딩 페이지와 슬라이더/슬라이드쇼 기능을 통합한 지식 공유 프레젠테이션 페이지를 만듭니다. 사용자가 랜딩 페이지와 슬라이더/슬라이드쇼 기능을 모두 명시적으로 요청할 때만 사용하세요. 일반 랜딩 페이지나 단독 슬라이더에는 사용하지 마세요.

랜딩 페이지 슬라이더란 무엇인가요?

이 스킬은 랜딩 페이지와 전체 화면 프레젠테이션 모드를 결합한 웹 페이지 제작을 위한 것입니다. 사용자가

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Funnyhust/POC_Kaenx_Creator/tree/HEAD/.agent/skills/landing-page-slider

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

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

문서

랜딩 페이지 슬라이더은(는) 무엇을 하나요?

키보드 내비게이션, 글래스모피즘 효과, 전문적인 애니메이션을 갖춘 아름다운 랜딩 페이지를 전체 화면 프레젠테이션으로 변환하세요.

이 스킬 사용 시기

[!IMPORTANT] 이 스킬은 랜딩 페이지 와 슬라이더/슬라이드쇼 기능이 모두 필요한 프로젝트를 위한 것입니다.

  • 사용자가 "랜딩 페이지 with 슬라이더" 또는 "프레젠테이션 랜딩 페이지"를 명시적으로 요청할 때
  • 슬라이드쇼 모드가 있는 지식 공유 페이지를 구축할 때
  • 프레젠테이션 모드로 전환할 수 있는 마케팅 사이트를 만들 때
  • 사용하지 말아야 할 경우: 일반 랜딩 페이지, 독립형 캐러셀/슬라이더, 단순 슬라이드쇼

기술 스택

기술버전용도
Vite5+빌드 도구
React18+UI 프레임워크
Tailwind CSSv4스타일링 (CSS 우선)
Lucide React최신전문 아이콘
Framer Motion최신애니메이션

빠른 시작

1단계: 프로젝트 생성

npm create vite@latest my-landing -- --template react-ts
cd my-landing
npm install

2단계: 종속성 설치

npm install tailwindcss @tailwindcss/vite lucide-react framer-motion

3단계: Vite 설정

// vite.config.ts
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import tailwindcss from '@tailwindcss/vite'

export default defineConfig({
  plugins: [react(), tailwindcss()],
})

4단계: Tailwind CSS v4 설정

/* src/index.css */
@import "tailwindcss";

@theme {
  /* P3 디스플레이를 위한 oklch 기본 그라데이션 색상 */
  --color-primary: oklch(0.65 0.18 250);
  --color-secondary: oklch(0.55 0.15 280);
  --color-accent: oklch(0.75 0.2 160);
  
  /* 글래스모피즘 색상 */
  --color-glass-bg: oklch(0.15 0.02 260 / 0.6);
  --color-glass-border: oklch(1 0 0 / 0.1);
  
  /* 애니메이션 */
  --animate-slide-in: slide-in 0.5s ease-out;
  --animate-fade-up: fade-up 0.6s ease-out;
  --animate-glow: glow 2s ease-in-out infinite;
}

@keyframes slide-in {
  from { transform: translateX(100%); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}

@keyframes fade-up {
  from { transform: translateY(20px); opacity: 0; }
  to { transform: translateY(0); opacity: 1; }
}

@keyframes glow {
  0%, 100% { box-shadow: 0 0 20px oklch(0.65 0.18 250 / 0.3); }
  50% { box-shadow: 0 0 40px oklch(0.65 0.18 250 / 0.6); }
}

핵심 컴포넌트

1. 슬라이더 컨테이너

프레젠테이션 모드와 슬라이드 탐색을 관리하는 메인 컴포넌트입니다.

주요 기능:

  • 랜딩 페이지와 프레젠테이션 모드 간 전환
  • 현재 슬라이드 인덱스 추적
  • 슬라이드 간 애니메이션 처리
  • 전체 화면 지원

2. 슬라이드 컴포넌트

전체 화면 슬라이드가 되는 개별 콘텐츠 섹션입니다.

주요 기능:

  • 콘텐츠 영역 (제목, 설명, 시각 자료)
  • 진입/퇴장 애니메이션
  • 글래스모피즘 카드 스타일링

3. 키보드 탐색 훅

키보드 단축키를 위한 커스텀 훅입니다.

키동작
← / →슬라이드 탐색
Space다음 슬라이드
Escape프레젠테이션 종료
F전체 화면 전환
P프레젠테이션 모드 전환

글래스모피즘 패턴

블러가 적용된 카드

<div className="
  bg-glass-bg 
  backdrop-blur-xl 
  border border-glass-border
  rounded-2xl 
  shadow-2xl
">
  {/* 콘텐츠 */}
</div>

그라데이션 오브 (배경)

<div className="absolute inset-0 overflow-hidden -z-10">
  <div className="
    absolute -top-40 -right-40 w-80 h-80 
    bg-primary/30 rounded-full blur-3xl
  " />
  <div className="
    absolute -bottom-40 -left-40 w-80 h-80 
    bg-secondary/30 rounded-full blur-3xl
  " />
</div>

애니메이션 패턴

계단식 자식 (Framer Motion)

const container = {
  hidden: { opacity: 0 },
  show: {
    opacity: 1,
    transition: { staggerChildren: 0.1 }
  }
}

const item = {
  hidden: { y: 20, opacity: 0 },
  show: { y: 0, opacity: 1 }
}

<motion.div variants={container} initial="hidden" animate="show">
  {items.map(i => <motion.div key={i} variants={item} />)}
</motion.div>

슬라이드 전환

<AnimatePresence mode="wait">
  <motion.div
    key={currentSlide}
    initial={{ x: 100, opacity: 0 }}
    animate={{ x: 0, opacity: 1 }}
    exit={{ x: -100, opacity: 0 }}
    transition={{ duration: 0.3, ease: "easeOut" }}
  >
    {slides[currentSlide]}
  </motion.div>
</AnimatePresence>

모범 사례

시각적 우수성

  1. 색상 조화 - 일관되고 생생한 그라데이션을 위해 oklch 색상 사용
  2. 깊이 계층 - 블러 + 투명도 + 미묘한 테두리 결합
  3. 동작 목적 - 산만함이 아닌 주의를 유도하기 위해 애니메이션 사용
  4. 다크 모드 우선 - 글래스모피즘은 어두운 배경에서 빛납니다

성능

  1. 지연 로딩 - 필요할 때 슬라이드 콘텐츠 로드
  2. will-change - 애니메이션 요소에 추가
  3. 동작 축소 - prefers-reduced-motion 존중

접근성

  1. 포커스 가시성 - 프레젠테이션 모드에서 명확한 포커스 표시기
  2. 키보드 탐색 - 전체 키보드 지원 (이미 내장)
  3. ARIA 레이블 - 탐색 컨트롤에 레이블 지정

결정 트리

무엇이 필요하신가요?
├── 새 랜딩 페이지 프로젝트
│   └── 빠른 시작 (1-4단계) 따르기
├── 기존 React 앱에 슬라이더 추가
│   └── 슬라이더 컴포넌트 + 훅 복사
├── 시각적 스타일 커스터마이징
│   └── CSS의 @theme 블록 수정
└── 키보드 단축키 변경
    └── useKeyboard 훅 수정

예제 및 리소스

예제

일반적인 실수

실수해결 방법
블러가 작동하지 않음부모에 position: relative 또는 overflow: hidden 추가
애니메이션이 끊김애니메이션 요소에 will-change: transform 추가
색상이 바랜 것처럼 보임더 넓은 색역 지원을 위해 oklch 사용
키보드가 작동하지 않음포커스가 컨테이너 요소에 있는지 확인

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬