Communitygithub.com

elcoosp/elcoosp-skills

使用現代化模式建立生產級 Next.js 著陸頁,包含 i18n、A/B 測試、等待名單、分析工具與精美 UI 元件。

elcoosp-skills 是什麼?

此技能提供了一個基於 [CodeBridge 著陸頁](https://codebridge.dev) 的完整架構與最佳實踐,協助開發者快速建立高品質的 Next.js 產品著陸頁。它涵蓋了國際化 (i18n)、A/B 測試、UTM 追蹤、等待名單註冊與分析工具等現代必備功能,並採用 App Router、TypeScript 與 Tailwind CSS 等技術棧。技能透過詳細的目錄結構、關鍵元件對照表與逐步操作指南,引導使用者在 `app/[lang]/` 動態路由下組織頁面,並在 `components/` 中區分區塊、共用元件與 UI 基底。支援平台為 Next.js 14+,並推薦搭配 Lingui 進行翻譯、Framer Motion 處理動畫、Turso 儲存等待名單資料,以及 Umami 作為分析服務。最終產出包含完整的著陸頁、部落格、常見問題、價格等頁面,並提供 A/B 測試基礎設施與即時等待人數計數器,讓開發者能專注於客製化而非從零開始。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elcoosp/elcoosp-skills/tree/HEAD/nextjs-landing-page

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

說明

使用此技能來搭建或學習如何為任何產品建立高品質的 Next.js 著陸頁。它包含了 CodeBridge 著陸頁 的架構、元件模式與最佳實踐,這是一個完整且達到生產等級的範例。

使用時機

  • 你需要為 SaaS 產品、開源專案或行動應用程式建立新的著陸頁。
  • 你想要實現現代化功能,例如國際化 (i18n)、A/B 測試、UTM 追蹤以及等待名單註冊表單。
  • 你在尋找一個乾淨、易於維護的 Next.js (App Router) 程式碼庫,搭配 Tailwind CSS 和 shadcn/ui。
  • 你想要了解如何使用伺服器元件、客戶端元件以及良好組織的檔案階層來建立大型 Next.js 應用程式。

如何使用

  1. 啟動一個新的 Next.js 專案 (如果尚未完成):

    npx create-next-app@latest my-landing --typescript --tailwind --app
    
  2. 安裝核心依賴 (如 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 文件)。

  3. 依照 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 定義
    
  4. 從 CodeBridge 程式碼庫複製關鍵模式:

    • i18n:使用 @lingui 搭配 [lang] 動態路由。伺服器元件取得翻譯,客戶端元件使用 <Trans>。
    • A/B 測試:透過 cookie/中介軟體 (proxy.ts) 指派變體,並透過 ABTestProvider 注入。
    • UTM 追蹤:解析 UTM 參數,儲存至 cookie (首次接觸),並透過 UTMContext 提供。
    • 分析工具:Umami (或類似服務) 搭配自訂事件追蹤 hooks (useAnalytics)。
    • 等待名單:資料庫 (Turso) + API 路由 + 即時計數器。
    • 動畫:使用 framer-motion 搭配 AnimatedSection 實現滾動觸發進入效果。
    • 主題:支援深色模式的 CSS 變數。
  5. 將區塊建構為可組合的客戶端元件 (在必要處使用 'use client')。每個區塊位於 components/sections/ 中,並匯入至 page.tsx。

  6. 加入吉祥物 (選用) – 請參閱 AnimatedMascot.tsx,它是一個有趣且會感知滾動的角色。

關鍵元件 (來自 CodeBridge 著陸頁)

元件用途
Hero主要標題、CTA 按鈕、即時等待人數計數器、終端機展示
FeatureBelt三個核心功能,附帶圖示與資訊彈窗
ComparisonTable與競爭對手的特色比較
WorktreeSection使用動畫圖表解釋平行工作目錄
HowItWorks三步驟安裝指南,附帶視覺輔助
PricingCards / PricingTableA/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 (或任何分析服務提供者)

相關技能