저장소 정적 랜딩 페이지은(는) 무엇을 하나요?
저장소에 있는 정보를 바탕으로 정적 랜딩 페이지(docs/index.html + docs/style.css + docs/main.js)를 생성합니다. 저장소에 실제로 없는 기능, 제공자 또는 명령어는 절대 나열하지 마세요.
콘텐츠의 진실 공급원(Source of Truth)
무엇이든 작성하기 전에 다음을 읽으십시오:
README.*— 개요, 기능, 기술 스택, 설치/빠른 시작 명령어LICENSE*— 라이선스 이름, 버전, URLCHANGELOG.*— 변경 이력 요약package.json,composer.json,requirements.txt등: 이름, 설명, 의존성 (기술 스택 배지의 기초)AGENTS.md,CLAUDE.md,config.toml,GEMINI.md등: 프로젝트의 목적 및 (있는 경우) 지원되는 제공자/설정 테이블- 기존
docs/index.html(있는 경우): 명시적으로 재설계를 요청하지 않는 한, 그 섹션 구조를 재사용하고 처음부터 다시 구축하지 말고 콘텐츠를 그 자리에서 편집하십시오.
필수 요소
-
라이트/다크 테마 —
prefers-color-scheme: dark미디어 쿼리로 CSS 사용자 정의 속성(--bg,--text,--accent등)을 재정의하십시오. 요청하지 않는 한 JS 테마 전환 버튼을 추가하지 마세요. -
OGP + Twitter/X 카드 —
og:title,og:description,og:url,og:image,og:type,og:site_name,twitter:card,twitter:title,twitter:description,twitter:image.og:image/twitter:image는 저장소에 실제로 존재하는 에셋(예:social-preview.png)을 가리키십시오. 없으면 먼저make-social-preview기술로 생성하십시오. -
JSON-LD 스키마 —
<script type="application/ld+json">블록(앱/도구의 경우SoftwareApplication, 그렇지 않으면 프로젝트에 맞는@type). OGP 설명과 일관성을 유지하십시오. -
파비콘 — 프로젝트에 적합한 Twemoji SVG를
<link rel="icon">으로 참조하십시오. -
multilanguagejs(CDN, 빌드 단계 없음)를 통한 다국어 지원:<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>번역할 모든 요소를
<template type="language-group">로 감싸고, 그 안에 각 언어에 대해 하나의 하위 요소를 배치하되 각각language="xx"속성(lang아님)을 사용하십시오:<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>각
template[type=language-group]은 지원되는 언어당 정확히 하나의 요소를 포함해야 합니다.multilanguagejs는 템플릿당 첫 번째 일치하는[language=X]를 취하므로, 중복되면 콘텐츠가 자동으로 손실됩니다.main.js에서 초기화하십시오:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // 로드 시 및 <select> 전환기의 변경 이벤트에서<title>및<meta name="description">는[language]템플릿의 범위 밖에 있습니다(라이브러리는 일치하는 요소의textContent만 업데이트하며,<meta>태그의 번역은 텍스트가 아닌content속성에 있습니다).main.js에 언어별{ title, description }사전을 작게 만들고ml.setLanguage()와 함께 이 두 태그를 수동으로 업데이트하십시오.navigator.language에서 방문자의 언어를 감지하고 선택한 언어를localStorage에 저장한 후, 로드 시 브라우저 감지로 돌아가기 전에 다시 적용하십시오.필수 언어 세트(항상, 앱 자체가 지원하는 것과 관계없이): 영어(
en), 일본어(ja), 중국어(zh), 스페인어(es), 러시아어(ru), 독일어(de) — 최소 6개 언어. 이는src/locales/*.json또는 앱 자체의i18n.ts/i18n.js가 이들 중 일부만을 다루더라도 적용됩니다(예:en/ja전용 앱의 경우에도 랜딩 페이지를 6개 언어로 만드십시오). 요청 시 이 6개 언어에 다른 언어를 추가할 수 있습니다. -
클립보드 복사 버튼 —
<code>블록에 표시된 모든 설치/실행 명령어에 인라인 SVG 아이콘(절대 이모지 사용 금지)이 있는 복사 버튼을 제공하고,navigator.clipboard.writeText()를 통해 확인 표시 상태를 표시하십시오. 일관된 레이아웃을 위해<code>와 버튼을.code-row플렉스 컨테이너로 감싸십시오. -
반응형 — 모바일 우선. 명시적으로 스크롤하도록 의도된 컨테이너(예: 넓은 비교 테이블)를 제외하고는 좁은 뷰포트에서 가로 스크롤이 발생하지 않도록 하십시오.
-
빌드 단계 없음 — 앱 자체가 어떤 번들러(Vite 등)를 사용하든 HTML 파일을 열거나 정적 폴더를 그대로 제공하기만 하면 페이지가 작동하도록 만드십시오.
main.js를 읽을 수 있는 소스로 유지하고<script src="main.js">로 페이지에 직접 로드하십시오. -
시맨틱 구조 — 다음을 시맨틱하게 구성하십시오: 히어로(제목, 리드 텍스트, CTA, 주요 실행 명령어), 스크린샷(있는 경우 기존 저장소/GitHub 에셋 URL 재사용), 기능 그리드, 빠른 시작/설치 명령어, 기술 스택 배지, 푸터.
-
기존 CSS 재사용 — 병렬적이고 분리된 스타일링 시스템을 만들지 말고 저장소의
docs/style.css에 이미 있는 CSS 사용자 정의 속성과 클래스 이름을 재사용하십시오. -
디자인 시스템 존중 — 기존 AI 에이전트 런타임 환경의 디자인 시스템을 존중하십시오. 새 CSS를 추가할 때는 기존 사용자 정의 속성과 클래스 이름을 재사용하고 저장소의 디자인 시스템과 일관된 명명 규칙, 디자인, 레이아웃, 어조 및 방식을 따르십시오.
워크플로우
- 위의 콘텐츠 소스를 읽으십시오.
docs/가 없으면 만드십시오.docs/index.html이 이미 있으면 그 자리에서 편집하십시오. 명시적으로 재설계를 요청하지 않는 한 완전히 교체하지 말고 섹션 구조를 유지하고 콘텐츠를 업데이트하십시오.- 섹션을 시맨틱하게 구성하십시오: 히어로(제목, 리드 텍스트, CTA, 주요 실행 명령어), 스크린샷(있는 경우 기존 저장소/GitHub 에셋 URL 재사용), 기능 그리드, 비교/설정 테이블(프로젝트에 비교할 만한 여러 제공자/모드/백엔드가 있는 경우), 빠른 시작/설치 명령어, 기술 스택 배지, 푸터.
- 병렬적이고 분리된 스타일링 시스템을 만들지 말고 저장소의
docs/style.css에 이미 있는 CSS 사용자 정의 속성과 클래스 이름을 재사용하십시오. docs/main.js를 업데이트하십시오.- 완료하기 전에 확인하십시오: 대화형 아이콘에 이모지가 사용되지 않음(SVG만); 모든
template[type=language-group]이 지원되는 각 언어에 대해 정확히 하나의 하위 요소를 가지며 중복이나 누락이 없음; OGP/JSON-LD가 저장소에 실제로 존재하는 파일/URL을 가리킴.