說明
使用此技能來搭建或學習如何為任何產品建立高品質的 Next.js 著陸頁。它包含了 CodeBridge 著陸頁 的架構、元件模式與最佳實踐,這是一個完整且達到生產等級的範例。
使用時機
- 你需要為 SaaS 產品、開源專案或行動應用程式建立新的著陸頁。
- 你想要實現現代化功能,例如國際化 (i18n)、A/B 測試、UTM 追蹤以及等待名單註冊表單。
- 你在尋找一個乾淨、易於維護的 Next.js (App Router) 程式碼庫,搭配 Tailwind CSS 和 shadcn/ui。
- 你想要了解如何使用伺服器元件、客戶端元件以及良好組織的檔案階層來建立大型 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-plugin若使用 i18n,請設定 Lingui (請參閱 Lingui 文件)。
-
依照 CodeBridge 模式組織你的應用程式結構:
app/ ├── [lang]/ # 動態語言區段 │ ├── layout.tsx # 包含字型、Provider 的根佈局 │ ├── 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 hooks ├── lib/ # 工具函式、設定、常數 ├── contexts/ # React context providers (例如 UTMContext) └── types/ # 全域 TypeScript 定義 -
從 CodeBridge 程式碼庫複製關鍵模式:
- i18n:使用
@lingui搭配[lang]動態路由。伺服器元件取得翻譯,客戶端元件使用<Trans>。 - A/B 測試:透過 cookie/中介軟體 (
proxy.ts) 指派變體,並透過ABTestProvider注入。 - UTM 追蹤:解析 UTM 參數,儲存至 cookie (首次接觸),並透過
UTMContext提供。 - 分析工具:Umami (或類似服務) 搭配自訂事件追蹤 hooks (
useAnalytics)。 - 等待名單:資料庫 (Turso) + API 路由 + 即時計數器。
- 動畫:使用
framer-motion搭配AnimatedSection實現滾動觸發進入效果。 - 主題:支援深色模式的 CSS 變數。
- i18n:使用
-
將區塊建構為可組合的客戶端元件 (在必要處使用
'use client')。每個區塊位於components/sections/中,並匯入至page.tsx。 -
加入吉祥物 (選用) – 請參閱
AnimatedMascot.tsx,它是一個有趣且會感知滾動的角色。
關鍵元件 (來自 CodeBridge 著陸頁)
| 元件 | 用途 |
|---|---|
Hero | 主要標題、CTA 按鈕、即時等待人數計數器、終端機展示 |
FeatureBelt | 三個核心功能,附帶圖示與資訊彈窗 |
ComparisonTable | 與競爭對手的特色比較 |
WorktreeSection | 使用動畫圖表解釋平行工作目錄 |
HowItWorks | 三步驟安裝指南,附帶視覺輔助 |
PricingCards / PricingTable | A/B 測試的價格顯示 |
LaunchCountdown | 倒數計時器 + 等待名單表單 |
TestimonialsSection | 使用者評論輪播 |
Footer | 連結、社群、版權資訊 |
最佳實踐
- 預設使用伺服器元件 – 將客戶端邏輯移至葉節點元件,或謹慎使用
'use client'。 - 集中化設定 –
lib/constants.ts、lib/ab-tests.ts、lib/roadmap-data.ts。 - 自訂 hooks – 封裝邏輯 (例如
useAnalytics、useChannelExperiment)。 - Context providers – 在
layout.tsx中包裹 (例如UTMProvider、ABTestProvider)。 - 環境變數 – 對客戶端可用的值使用
NEXT_PUBLIC_*。 - 無障礙設計 – 焦點指示器、ARIA 標籤、鍵盤導航 (請參閱
InfoPopover.tsx)。 - 效能 – 懶載入摺疊下方的圖片、使用
next/image、預載字型。
產出
遵循此技能後,你將獲得:
- 一個使用 App Router、TypeScript、Tailwind CSS 與 shadcn/ui 的 Next.js 專案。
- 一個完全本地化的著陸頁 (英文、法文、西班牙文),支援動態路由。
- 基於 cookie 的 A/B 測試基礎設施。
- 首次接觸歸因的 UTM 追蹤。
- 使用 Turso 資料庫的等待名單註冊與即時計數器。
- 精美、響應式的使用者介面,包含動畫與吉祥物。
- 部落格、更新記錄、常見問題、價格與法律條款頁面。
範例
範例 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 測試實作基於 cookie,若無專門服務可能無法擴展至數百萬使用者。
依賴
- Next.js 14+ (App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui (非必要但大量使用)
- Lingui (用於 i18n)
- Framer Motion (用於動畫)
- Turso / libSQL (用於等待名單資料庫)
- Umami (或任何分析服務提供者)