지침
이 스킬을 사용하여 모든 제품에 대한 고품질 Next.js 랜딩 페이지를 스캐폴딩하거나 구축 방법을 학습하세요. 이 스킬은 완전히 기능하는 프로덕션 등급 예시인 CodeBridge 랜딩 페이지의 아키텍처, 컴포넌트 패턴 및 모범 사례를 담고 있습니다.
사용 시기
- SaaS 제품, 오픈소스 프로젝트 또는 모바일 앱을 위한 새로운 랜딩 페이지가 필요할 때.
- 국제화(i18n), A/B 테스트, UTM 추적, 대기자 명단 가입 양식과 같은 현대적인 기능을 구현하고자 할 때.
- Tailwind CSS 및 shadcn/ui를 사용하는 깔끔하고 유지보수 가능한 Next.js (App Router) 코드베이스를 찾고 있을 때.
- 서버 컴포넌트, 클라이언트 컴포넌트 및 잘 구성된 파일 계층 구조를 갖춘 대규모 Next.js 애플리케이션을 구조화하는 방법을 이해하고 싶을 때.
사용 방법
-
새로운 Next.js 프로젝트 시작 (아직 시작하지 않은 경우):
npx create-next-app@latest my-landing --typescript --tailwind --app -
핵심 종속성 설치 (CodeBridge
package.json에서 확인):npm install @lingui/core @lingui/react framer-motion lucide-react @icons-pack/react-simple-icons canvas-confetti npm install -D @lingui/cli @lingui/swc-plugini18n을 위해 Lingui를 설정하세요 (Lingui 문서 참조).
-
CodeBridge 패턴에 따라 앱 구조화:
app/ ├── [lang]/ # 동적 언어 세그먼트 │ ├── layout.tsx # 글꼴, 프로바이더가 포함된 루트 레이아웃 │ ├── page.tsx # 홈페이지 – 섹션 구성 │ ├── globals.css # Tailwind + 커스텀 변수 │ ├── ABTestLayoutClient.tsx │ ├── blog/ # 블로그 페이지 │ ├── changelog/ │ ├── faq/ │ ├── features/ │ ├── pricing/ │ ├── privacy/ │ ├── security/ │ └── terms/ ├── components/ │ ├── sections/ # 대형 페이지 섹션 (Hero, Features, Pricing…) │ ├── shared/ # 재사용 가능한 컴포넌트 (Header, Footer, Terminal…) │ ├── ui/ # shadcn/ui 컴포넌트 (button, card, …) │ └── mascot/ # 커스텀 애니메이션 마스코트 ├── hooks/ # 커스텀 React 훅 ├── lib/ # 유틸리티, 설정, 상수 ├── contexts/ # React 컨텍스트 프로바이더 (예: UTMContext) └── types/ # 전역 TypeScript 정의 -
CodeBridge 코드베이스에서 주요 패턴 복사:
- i18n:
[lang]동적 라우트와 함께@lingui사용. 서버 컴포넌트는 번역을 가져오고, 클라이언트 컴포넌트는<Trans>를 사용. - A/B 테스트: 쿠키/미들웨어(
proxy.ts)를 통해 변형 할당하고ABTestProvider를 통해 주입. - UTM 추적: UTM 매개변수를 구문 분석하여 쿠키(퍼스트 터치)에 저장하고
UTMContext를 통해 사용 가능하게 함. - 분석: 커스텀 이벤트 추적 훅(
useAnalytics)과 함께 Umami (또는 유사 서비스) 사용. - 대기자 명단: 데이터베이스(Turso) + API 라우트 + 실시간 카운터.
- 애니메이션: 스크롤 트리거 진입을 위한
AnimatedSection과 함께framer-motion사용. - 테마: 다크 모드 지원을 위한 CSS 변수.
- i18n:
-
섹션 빌드: 구성 가능한 클라이언트 측 컴포넌트(필요한 경우
'use client'사용)로 작성. 각 섹션은components/sections/에 위치하며page.tsx로 가져옵니다. -
마스코트 추가 (선택 사항) – 재미있는 스크롤 인식 캐릭터는
AnimatedMascot.tsx를 참조.
핵심 컴포넌트 (CodeBridge 랜딩 페이지에서 발췌)
| 컴포넌트 | 목적 |
|---|---|
Hero | 주요 헤드라인, CTA 버튼, 라이브 대기자 카운터, 터미널 데모 |
FeatureBelt | 아이콘과 정보 팝오버가 있는 세 가지 핵심 기능 |
ComparisonTable | 경쟁사 대비 기능 비교 |
WorktreeSection | 애니메이션 다이어그램으로 병렬 워크트리 설명 |
HowItWorks | 시각 자료가 포함된 3단계 설치 가이드 |
PricingCards / PricingTable | A/B 테스트된 가격 표시 |
LaunchCountdown | 카운트다운 타이머 + 대기자 양식 |
TestimonialsSection | 사용자 인용문 캐러셀 |
Footer | 링크, 소셜, 저작권 |
모범 사례
- 기본적으로 서버 컴포넌트 – 클라이언트 로직은 리프 컴포넌트로 이동하거나
'use client'를 절약해서 사용. - 중앙 집중식 설정 –
lib/constants.ts,lib/ab-tests.ts,lib/roadmap-data.ts. - 커스텀 훅 – 로직 캡슐화 (예:
useAnalytics,useChannelExperiment). - 컨텍스트 프로바이더 –
layout.tsx에서 래핑 (예:UTMProvider,ABTestProvider). - 환경 변수 – 클라이언트 측 값에
NEXT_PUBLIC_*사용. - 접근성 – 포커스 표시기, ARIA 레이블, 키보드 탐색 (
InfoPopover.tsx참조). - 성능 – 폴드 아래 이미지는 지연 로딩,
next/image사용, 글꼴 미리 로드.
결과물
이 스킬을 따라 하면 다음을 갖게 됩니다:
- App Router, TypeScript, Tailwind CSS 및 shadcn/ui를 사용하는 Next.js 프로젝트.
- 동적 라우팅이 있는 완전히 지역화된 랜딩 페이지 (영어, 프랑스어, 스페인어).
- 쿠키 기반 변형 할당을 갖춘 A/B 테스트 인프라.
- 퍼스트 터치 속성을 사용한 UTM 추적.
- Turso 데이터베이스 및 실시간 카운터가 있는 대기자 명단 가입.
- 애니메이션 및 마스코트가 있는 세련되고 반응형 UI.
- 블로그, 체인지로그, FAQ, 가격 및 법률 페이지.
예시
예시 1: 새로운 SaaS 제품을 위한 랜딩 페이지 만들기
사용자: "TaskFlow"라는 새 프로젝트 관리 도구를 위한 랜딩 페이지가 필요합니다.
에이전트: CodeBridge의 패턴을 사용하여 Next.js 랜딩 페이지를 구축해 드리겠습니다.
먼저 프로젝트를 생성해 보겠습니다:
npx create-next-app@latest taskflow-landing --typescript --tailwind --app
그런 다음 종속성을 설치하고 스킬에 설명된 대로 구조를 설정하겠습니다.
예시 2: 기존 랜딩 페이지에 대기자 명단 양식 추가하기
사용자: 라이브 카운터가 있는 대기자 명단 양식을 어떻게 추가하나요?
에이전트: 스킬에서 `WaitlistForm` 컴포넌트, `/api/subscribe` 라우트 및 데이터베이스 스키마를 복사하세요. 그런 다음 Turso 데이터베이스를 설정하고 환경 변수를 추가하세요.
제한 사항
- 이 스킬은 아키텍처 지침을 제공하며, 자동 코드 생성기가 아닙니다. 패턴을 수동으로 복사하고 적용해야 합니다.
- i18n 설정은 Lingui를 가정합니다. 원하는 경우
next-intl또는 다른 라이브러리로 대체할 수 있습니다. - A/B 테스트 구현은 쿠키 기반이며 전용 서비스 없이 수백만 사용자로 확장되지 않을 수 있습니다.
종속성
- Next.js 14+ (App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui (선택 사항이지만 많이 사용됨)
- Lingui (i18n용)
- Framer Motion (애니메이션용)
- Turso / libSQL (대기자 명단 데이터베이스용)
- Umami (또는 모든 분석 제공자)