Communitygithub.com

elcoosp/elcoosp-skills

使用现代模式创建生产级 Next.js 落地页——支持国际化、A/B 测试、候补名单收集、分析功能和精美的 UI 组件。

elcoosp-skills 是什么?

该技能旨在帮助开发者和 AI 代理使用 Next.js 构建高质量的生产级落地页。它基于 CodeBridge 落地页的实际架构、组件模式和最佳实践,提供了一个完整的参考实现。支持的平台包括 Next.js 14+(App Router)、TypeScript、Tailwind CSS 和 shadcn/ui。该技能详细涵盖了技术栈和项目结构建议,包括国际化(i18n)通过 `@lingui` 和动态路由 `[lang]` 实现;A/B 测试通过 cookie 分配实验变体;UTM 追踪实现首次触点归因;以及使用 Turso 数据库作为后端的候补名单注册表单。输出的是一个可部署的项目,包含 Hero、功能展示、对比表、定价、博客、FAQ 等常见页面部分,并集成了动画(framer-motion)、黑暗模式和分析追踪(Umami)。该技能提供架构指导,需要用户根据说明手动复制和调整模式,而不是全自动生成代码。

兼容平台~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 追踪和候补名单注册表单等现代功能。
  • 你正在寻找一个使用 Tailwind CSS 和 shadcn/ui 的干净、可维护的 Next.js(App Router)代码库。
  • 你想了解如何构建一个包含服务端组件、客户端组件和良好组织结构的大型 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          # 包含字体和提供者的根布局
    │   ├── 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 定义
    
  4. 从 CodeBridge 代码库复制关键模式:

    • i18n:使用带有动态路由 [lang] 的 @lingui。服务端组件获取翻译,客户端组件使用 <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主标题、号召性用语按钮、实时候补名单计数器、终端演示
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(或任何分析提供者)

相关技能