指示
このスキルを使用して、あらゆるプロダクト向けの高品質な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:
@linguiを[lang]動的ルートとともに使用。サーバーコンポーネントは翻訳をフェッチし、クライアントコンポーネントは<Trans>を使用。 - A/Bテスト: クッキー/ミドルウェア(
proxy.ts)経由でバリアントを割り当て、ABTestProvider経由で注入。 - UTMトラッキング: UTMパラメータを解析し、クッキーに保存(初回タッチ)、
UTMContext経由で利用可能にする。 - アナリティクス: Umami(または類似)とカスタムイベントトラッキングフック(
useAnalytics)。 - ウェイトリスト: データベース(Turso)+ APIルート + ライブカウンター。
- アニメーション: スクロールトリガーエントランス用の
framer-motionとAnimatedSection。 - テーマ設定: ダークモード対応のCSS変数。
- i18n:
-
セクションを構築する – コンポーザブルなクライアントサイドコンポーネントとして(必要な箇所で
'use client'を使用)。各セクションはcomponents/sections/に配置され、page.tsxでインポートされます。 -
マスコットを追加する(オプション) –
AnimatedMascot.tsxを参照して、スクロールに対応した楽しいキャラクターを追加できます。
主要コンポーネント(CodeBridgeランディングページより)
| コンポーネント | 目的 |
|---|---|
Hero | メイン見出し、CTAボタン、ライブウェイトリストカウンター、ターミナルデモ |
FeatureBelt | アイコンと情報ポップオーバー付きの3つのコア機能 |
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(または任意のアナリティクスプロバイダー)