제품 랜딩 사이트
Kesami 마케팅 사이트에서 추출한 레시피로, 템플릿처럼 보이지 않고 설계된 느낌을 주며 꼼꼼히 검증된 단일 정적 페이지를 만듭니다. 대비 확인, 키보드 친화성, 제품에 대한 정직함, 빠른 속도를 갖춥니다.
결과물은 서버 렌더링된 섹션으로 구성된 하나의 Next.js 페이지입니다. 인터랙티브는 재렌더링 대신 DOM 속성이나 CSS 변수를 토글하는 소수의 클라이언트 '아일랜드'로 제한됩니다. UI 라이브러리, Tailwind, 애니메이션 라이브러리가 없습니다.
포함된 항목
| 경로 | 용도 |
|---|---|
assets/scaffold/ | 완전하고 빌드 가능한 사이트 (타입체크 및 next build 검증 완료). 복사해서 사용하고 다시 입력하지 마세요. 플레이스홀더 콘텐츠, 작동하는 디자인 시스템 포함. |
assets/optional-sections/ | 원본 사이트의 세 가지 추가 섹션 (전/후 비교, 데이터 경계 파일 트리, 스크립트 월)을 작업 예제로 제공. 연결되지 않음. |
scripts/accent.mjs | 모든 브랜드 컬러에 대해 대비 안전한 악센트 음영을 도출합니다. |
scripts/capture.cjs | 오프스크린 Electron 창을 통해 실행 중인 사이트의 데스크톱 및 휴대폰 너비 스크린샷을 스크롤 단계별로 캡처합니다. |
references/design-system.md | 토큰, 테마, 타입, 간격, 악센트-대비 로직 및 각각의 존재 이유. 색상이나 타입 변경 전에 읽으세요. |
references/section-patterns.md | 모든 섹션: 목적, 구축 방법, 비용 절감 비결. 섹션을 추가하거나 변경하기 전에 읽으세요. |
references/motion-and-a11y.md | 모션 예산, 축소 모션, JS 없음, 터치 대상, 하이드레이션 트랩. 애니메이션이나 클라이언트 코드를 추가하기 전에 읽으세요. |
references/copy-and-facts.md | 톤, 하나의 시나리오 규칙, 주장을 사실로 유지하는 방법. 카피 작성 전에 읽으세요. |
references/verify.md | 사이트 완료 전 실행해야 할 체크리스트와 명령어. |
작업 흐름
1. 입력 수집 (묻기 전에 먼저 살펴보기)
먼저 제품의 README, 패키지 매니페스트, 가격/요금제 코드 및 릴리스 워크플로를 읽으세요. 대부분의 답변이 거기에 있습니다. 찾을 수 없는 것에 대해서만 사용자에게 물어보세요. 필요한 항목:
- 제품 이름, 한 문장으로 된 약속, 대상 사용자, 그리고 차별화 요소 하나.
- 플랫폼, 가격 포인트 및 요금제 한도, 각각의 출처 파일.
- 브랜드 컬러 (아무 헥스값), 또는 하나를 선택할 권한. 단일 색상을 선택하여 유일한 시그널 컬러로 사용하세요.
- 라이선스된 디스플레이 폰트가 있는지 여부. 없으면 스캐폴드의 오픈 라이선스 대체 폰트(Instrument Serif)로 충분합니다.
- 적용할 섹션. 기본 세트: 히어로, 티커, 작동 방식, 질문/데모, 가격, FAQ, 마무리, 푸터. 제품에 스토리가 필요한 경우 개인정보 보호, 언어 또는 전/후 비교를 추가하세요.
- 사이트 위치. 기본값: 제품 저장소 내
website/폴더, npm 워크스페이스 외부의 독립 패키지로 앱의 설치 및 잠금 파일에 영향을 주지 않습니다.
2. 스캐폴드
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
편집 전에 한 번 빌드하여 기준선이 녹색인지 확인하세요. Mona Sans는 빌드 시간에 Google Fonts에서 가져온 후 사이트 자체에서 제공되므로 첫 번째 빌드는 네트워크가 필요합니다.
3. 브랜딩
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex>는--accent,--accent-display, 플래트닝된 틴트, 그리고 버튼 레이블이 잉크 색상이어야 하는지 흰색이어야 하는지를 출력합니다. 이 값들을app/globals.css(--brand,--brand-hover,--brand-tint,--accent,--accent-display)에 넣고app/icon.svg및app/opengraph-image.tsx의 하드코딩된#ff5e00/#e25300을 교체하세요.components/Logo.tsx및Logo.module.css에서 마크를 다시 그리세요 (플레이스홀더는 4개의 음성 막대입니다). div나 인라인 SVG로 유지하고 래스터는 절대 사용하지 마세요.lib/site.ts에서SITE를 설정하세요 (이름, 슬러그, 워드마크, 헤드라인, 리드, CTA, 참고사항).슬러그는 localStorage의 통화 환경설정을 네임스페이스로 구분합니다.
스크립트를 사용하는 이유 (눈대중 대신): 채도가 높은 브랜드 컬러는 밝은 페이지에서 텍스트로 4.5:1에 거의 도달하지 못하므로, 페이지는 채움용 브랜드 컬러와 텍스트용 더 어두운 형제 색상이 필요합니다. 형제 색상을 추측하는 것은 대비 실패 사이트를 만드는 방법입니다.
4. 카피보다 사실 먼저
제품의 자체 소스 파일에서 lib/site.ts (요금제, 플랫폼, 링크, FAQ)를 채우고 각 사실의 출처를 사이트의 README.md에 "사실 출처" 아래에 기록하세요. 코드 주석 대신 README에 출처를 보관하여 스캐폴드를 주석 없이 유지하세요. 대상 저장소나 사용자가 설명 주석을 요청하면 그렇게 하세요.
그런 다음 references/copy-and-facts.md를 읽고 카피를 작성하세요.
5. 하나의 시나리오, 모든 곳에서 공유
lib/demo.ts는 히어로 목업, 제품 스토리 및 인터랙티브 데모에서 모두 참조하는 단일 가상 시나리오를 보유합니다. 이를 제품 자체 도메인의 시나리오(지원 티켓, 풀 리퀘스트, 캘린더, 스프레드시트, 회의)로 교체하세요. 모든 섹션이 동일한 데이터를 읽기 때문에 페이지는 결코 모순되지 않으며 데모는 제품의 실제 계약을 정직하게 보여줄 수 있습니다 (예: 모든 주장이 출처를 인용).
6. 섹션
스캐폴드의 9개 섹션부터 시작하세요. 각 섹션마다 결정하세요: 하나의 아이디어는 무엇이며, 그것을 설명하지 않고 증명하는 하나의 시각적 요소는 무엇인지. references/section-patterns.md를 읽으세요. 섹션 문법을 따르세요:
- 레이블 칩 (
.label,data-scramble포함), 그 다음.em에 마지막 단어가 있는h2.display.h2, 그 다음 선택적.lead - 섹션은
data-theme="light"/"paper"를 번갈아 사용하여 각각 색상 경계에서 시작하고 선으로 구분되지 않음 - 뷰포트당 하나의 채워진 버튼; 나머지는 모두 브랜드 밑줄이 있는 텍스트 링크
- 제품 목업은
data-theme="dark"와 px 크기를 사용합니다. 이는 (어두운) 앱의 스크린샷을 대표하기 때문입니다. 앱이 밝으면 목업도 밝게 만드세요.
7. 검증
references/verify.md를 따르세요. 요약: 타입체크, 빌드, scripts/capture.cjs로 1440 및 390에서 스크린샷 캡처, 읽기, 스크롤 단계별로 리빌이 실행되는지 확인, 축소 모션 및 JS 없음 확인, 새로운 텍스트 색상에 대해 accent.mjs --check 재실행. 검증되지 않은 사항은 검증된 것처럼 암시하지 말고 보고하세요.
비협상 조건 및 이유
- 서버 컴포넌트 기본; 동작만을 위한 클라이언트 아일랜드. 페이지는 JS 없이 작동하고 거의 비용 없이 하이드레이션되는 정적 HTML입니다. 아일랜드는
data-*속성이나 CSS 변수를 작성하고 CSS가 시각적 작업을 수행하도록 합니다. - 컴포넌트에는 시맨틱 토큰만 사용. 컴포넌트는
--bg,--fg,--accent를 읽습니다. 섹션의data-theme이 이를 교체합니다. 이것이 하나의 컴포넌트가 Canvas, 흰색, 틴트 또는 어두운 목업 위에 수정 없이 위치할 수 있는 방법입니다. - 텍스트 크기는 rem, 목업은 px. 독자의 브라우저 텍스트 크기가 페이지에 적용되어야 합니다. 목업은 스크린샷을 대표합니다.
- 흐린 텍스트는 opacity가 아닌 색상으로 퇴색. Opacity는 조용히 대비를 4.5:1 아래로 낮춥니다.
- 카피는 제품을 넘어서지 않음. 출시되지 않은 플랫폼, 존재하지 않는 지원 주소, 오디오가 서버로 스트리밍되는데 "장치를 떠나지 않는다"는 주장 없음. 과장된 마케팅 페이지는 버그입니다.
- 애니메이션 일시정지 컨트롤이 내장되어 있지 않음. 반복 모션은
prefers-reduced-motion에 대해 중지됩니다. Kesami 디자인 리뷰에서 의도적으로 일시정지 컨트롤을 거부했으므로 스캐폴드에는 없습니다. 사용자가 원하면 제공하세요.
스캐폴드 너머로 확장
라이브러리를 가져오는 대신 동일한 기본 요소로 새 섹션을 만드세요: 상태에 대한 CSS 커스텀 프로퍼티, 동작당 하나의 IntersectionObserver, 공개를 위한 details/summary, 스크롤텔링을 위한 position: sticky, 변수 애니메이션을 위한 @property. framer-motion이나 캐러셀 패키지를 사용하려는 경우 먼저 references/motion-and-a11y.md를 다시 읽으십시오. 거의 항상 CSS 변수와 속성이 답입니다.