说明
使用此技能搭建或学习如何为任何产品构建高质量的 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-plugin对于 i18n,请设置 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 hooks ├── lib/ # 工具函数、配置、常量 ├── contexts/ # React context 提供者 (例如 UTMContext) └── types/ # 全局 TypeScript 定义 -
从 CodeBridge 代码库复制关键模式:
- i18n:使用带有动态路由
[lang]的@lingui。服务端组件获取翻译,客户端组件使用<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 | 主标题、号召性用语按钮、实时候补名单计数器、终端演示 |
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 提供者 – 在
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 数据库和实时计数器的候补名单注册。
- 具有动画和吉祥物的精美响应式 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 测试实现基于 cookie,如果没有专用服务,可能无法扩展到数百万用户。
依赖项
- Next.js 14+(App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui(可选,但大量使用)
- Lingui(用于 i18n)
- Framer Motion(用于动画)
- Turso / libSQL(用于候补名单数据库)
- Umami(或任何分析提供者)