プロダクトランディングサイト は何をしますか?
Kesamiマーケティングサイトから抽出した、テンプレート的に見えるのではなく、デザインされた印象を与え、細部まで吟味に耐える単一の静的ページのためのレシピです。コントラストチェック済み、キーボードフレンドリー、製品に正直、そして高速です。
結果は、サーバーレンダリングされたセクションで構成される1つのNext.jsページです。インタラクティビティは少数の小さなクライアント「アイランド」に限定され、これらは再レンダリングの代わりにDOM属性またはCSS変数を切り替えます。UIライブラリ、Tailwind、アニメーションライブラリは使用しません。
バンドルされるもの
| パス | 用途 |
|---|---|
assets/scaffold/ | 完全でビルド可能なサイト(型チェック済み、next build確認済み)。コピーして使用し、再入力しないでください。プレースホルダーコンテンツと動作するデザインシステムが含まれています。 |
assets/optional-sections/ | 元のサイトからの3つの追加セクション(Before/After比較、データ境界ファイルツリー、スクリプトウォール)の実例です。配線はされていません。 |
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、パッケージマニフェスト、料金/プランコード、リリースワークフローを読んでください。ほとんどの答えはそこにあります。ユーザーに尋ねるのは、見つからなかったものだけにしてください。必要なものは以下の通りです:
- 製品名、一言の約束、誰のためのものか、そして他と一線を画すもの。
- プラットフォーム、価格帯、プラン制限。それぞれについて、それが真実の源泉となるファイルを特定してください。
- ブランドカラー(任意のhex値)、または選択する許可。単一の色を選び、唯一のシグナルカラーとして使用します。
- ライセンスされたディスプレイフォントが存在するかどうか。ない場合は、スキャフォールドのオープンライセンス代替フォント(Instrument Serif)で問題ありません。
- 適用するセクション。デフォルトセット:Hero、ticker、How it works、Ask/demo、Pricing、FAQ、Closing、Footer。製品に必要なストーリーがある場合は、Privacy、Languages、またはBefore/After比較セクションを追加します。
- サイトの配置場所。デフォルト:製品リポジトリ内の
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定数を設定してください(name、slug、wordmark、headline、lead、CTA、note)。slugはlocalStorage内の通貨設定の名前空間としても使用されます。
スクリプトを使用する理由(目視ではない理由):彩度の高いブランドカラーは、明るいページ上でテキストとして4.5:1のコントラスト比を達成することはほとんどありません。そのため、ページは塗りつぶしにはブランドカラーを、テキストにはより暗い兄弟色を使用する必要があります。兄弟色を推測することは、コントラスト基準を満たさないサイトを生み出す原因です。
4. コピーの前に事実
製品自身のソースファイルから lib/site.ts(plans、platform、links、FAQ)を埋め、各事実の出典をサイトの README.md の「Where the facts come from」セクションに記録してください。出典情報はコードコメントではなく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"を交互に使用し、各セクションが罫線ではなく色のエッジで始まるようにします - ビューポートごとに1つの塗りつぶしボタン。それ以外はすべて、ブランドの下線を持つテキストリンクです
- プロダクトモックには
data-theme="dark"とpxサイズを使用します。これらは(ダークな)アプリのスクリーンショットの代わりとなるためです。アプリがライトの場合は、モックもライトにします。
7. 検証
references/verify.md に従ってください。簡潔に言うと:型チェック、ビルド、scripts/capture.cjs を使用した1440pxと390pxでのスクリーンショット、それらを確認、スクロールをステップ実行してリビールが機能していることを確認、動きの抑制とJSなしの状態をチェック、新しいテキスト色に対して accent.mjs --check を再実行。検証されていないことを、あたかも検証されたかのように報告しないでください。
譲歩できない点、およびその理由
- デフォルトでサーバーコンポーネント。クライアントアイランドは動作のみ。 ページはJSなしで動作し、ハイドレーションコストがほぼゼロの静的HTMLです。アイランドは
data-*属性またはCSS変数を書き込み、CSSに視覚的な処理を任せます。 - コンポーネントではセマンティックトークンのみを使用。 コンポーネントは
--bg、--fg、--accentを読み取ります。セクションのdata-themeがそれらを切り替えます。これにより、1つのコンポーネントがCanvas、白、ティント、またはダークモック上で編集なしに配置できるようになります。 - テキストサイズはrem、モックはpx。 読者のブラウザテキストサイズがページに適用される必要があります。モックはスクリーンショットの代わりです。
- 薄暗いテキストは色で表現し、不透明度では表現しない。 不透明度は静かにコントラストを4.5:1以下に低下させます。
- コピーは製品の現状を超えない。 未リリースのプラットフォーム、存在しないサポートアドレス、音声がサーバーにストリーミングされる場合の「デバイス外にデータは出ません」といった表現は禁止です。過剰な約束をするマーケティングページはバグです。
- アニメーションポーズコントロールは組み込まれていない。 ループするモーションは
prefers-reduced-motionに対して停止します。Kesamiのデザインレビューで意図的にポーズコントロールが却下されたため、スキャフォールドにもありません。ユーザーが希望する場合は提供してください。
スキャフォールドを超えた拡張
ライブラリをインポートする代わりに、同じプリミティブを使用して新しいセクションを発明してください:状態用のCSSカスタムプロパティ、動作ごとに1つのIntersectionObserver、開示用の details/summary、スクロールストーリーテリング用の position: sticky、変数アニメーション用の @property。framer-motionやカルーセルパッケージに手を伸ばしていることに気づいたら、まず references/motion-and-a11y.md を読み直してください。答えはほとんどの場合、CSS変数と属性です。