Communitygithub.com

elcoosp/elcoosp-skills

프로덕션 수준의 Next.js 랜딩 페이지를 현대적인 패턴(i18n, A/B 테스트, 대기자 명단 수집, 분석, 깔끔한 UI 컴포넌트)으로 만듭니다.

elcoosp-skills란 무엇인가요?

이 스킬은 개발자가 프로덕션 준비가 완료된 Next.js 랜딩 페이지를 빠르게 구축할 수 있도록 설계된 종합 가이드입니다. 실제 운영 중인 [CodeBridge 랜딩 페이지](https://codebridge.dev)의 아키텍처, 컴포넌트 패턴, 모범 사례를 기반으로 하여 SaaS 제품, 오픈소스 프로젝트 또는 모바일 앱을 위한 랜딩 페이지를 만들 때 유용합니다. Next.js 14+ (App Router), TypeScript, Tailwind CSS, shadcn/ui를 사용하며, @lingui를 활용한 국제화(i18n), 쿠키 기반 A/B 테스트, UTM 추적, 대기자 명단(수집/라이브 카운터) 및 Umami 분석과 같은 현대적인 기능을 포함합니다. 스킬은 서버 컴포넌트와 클라이언트 컴포넌트의 구조, framer-motion 애니메이션, 커스텀 마스코트, 블로그/체인지로그/FAQ/가격/법률 페이지 등을 제공하여 완성도 높은 결과물을 보장합니다. 모든 디렉토리 구조, 핵심 컴포넌트(Hero, FeatureBelt, PricingCards 등), 환경 변수 설정, 그리고 예시 명령어와 함께 단계별 지침을 제공하여 개발자가 바로 따라할 수 있습니다.

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

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

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

문서

지침

이 스킬을 사용하여 모든 제품에 대한 고품질 Next.js 랜딩 페이지를 스캐폴딩하거나 구축 방법을 학습하세요. 이 스킬은 완전히 기능하는 프로덕션 등급 예시인 CodeBridge 랜딩 페이지의 아키텍처, 컴포넌트 패턴 및 모범 사례를 담고 있습니다.

사용 시기

  • SaaS 제품, 오픈소스 프로젝트 또는 모바일 앱을 위한 새로운 랜딩 페이지가 필요할 때.
  • 국제화(i18n), A/B 테스트, UTM 추적, 대기자 명단 가입 양식과 같은 현대적인 기능을 구현하고자 할 때.
  • Tailwind CSS 및 shadcn/ui를 사용하는 깔끔하고 유지보수 가능한 Next.js (App Router) 코드베이스를 찾고 있을 때.
  • 서버 컴포넌트, 클라이언트 컴포넌트 및 잘 구성된 파일 계층 구조를 갖춘 대규모 Next.js 애플리케이션을 구조화하는 방법을 이해하고 싶을 때.

사용 방법

  1. 새로운 Next.js 프로젝트 시작 (아직 시작하지 않은 경우):

    npx create-next-app@latest my-landing --typescript --tailwind --app
    
  2. 핵심 종속성 설치 (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-plugin
    

    i18n을 위해 Lingui를 설정하세요 (Lingui 문서 참조).

  3. 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 정의
    
  4. CodeBridge 코드베이스에서 주요 패턴 복사:

    • i18n: [lang] 동적 라우트와 함께 @lingui 사용. 서버 컴포넌트는 번역을 가져오고, 클라이언트 컴포넌트는 <Trans>를 사용.
    • A/B 테스트: 쿠키/미들웨어(proxy.ts)를 통해 변형 할당하고 ABTestProvider를 통해 주입.
    • UTM 추적: UTM 매개변수를 구문 분석하여 쿠키(퍼스트 터치)에 저장하고 UTMContext를 통해 사용 가능하게 함.
    • 분석: 커스텀 이벤트 추적 훅(useAnalytics)과 함께 Umami (또는 유사 서비스) 사용.
    • 대기자 명단: 데이터베이스(Turso) + API 라우트 + 실시간 카운터.
    • 애니메이션: 스크롤 트리거 진입을 위한 AnimatedSection과 함께 framer-motion 사용.
    • 테마: 다크 모드 지원을 위한 CSS 변수.
  5. 섹션 빌드: 구성 가능한 클라이언트 측 컴포넌트(필요한 경우 'use client' 사용)로 작성. 각 섹션은 components/sections/에 위치하며 page.tsx로 가져옵니다.

  6. 마스코트 추가 (선택 사항) – 재미있는 스크롤 인식 캐릭터는 AnimatedMascot.tsx를 참조.

핵심 컴포넌트 (CodeBridge 랜딩 페이지에서 발췌)

컴포넌트목적
Hero주요 헤드라인, CTA 버튼, 라이브 대기자 카운터, 터미널 데모
FeatureBelt아이콘과 정보 팝오버가 있는 세 가지 핵심 기능
ComparisonTable경쟁사 대비 기능 비교
WorktreeSection애니메이션 다이어그램으로 병렬 워크트리 설명
HowItWorks시각 자료가 포함된 3단계 설치 가이드
PricingCards / PricingTableA/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 (또는 모든 분석 제공자)

관련 스킬