产品营销网站
一个源自 Kesami 营销网站的配方,用于构建一个看起来经过精心设计而非套用模板的单一静态页面,并且经得起推敲:经过对比度检查、键盘友好、诚实地展示产品、速度飞快。
最终产物是一个由服务端渲染的各章节组成的 Next.js 页面。交互性被限制在少数几个小的客户端“孤岛”中,这些孤岛通过翻转 DOM 属性或 CSS 变量来实现交互,而不是重新渲染。没有使用 UI 库、Tailwind 或动画库。
包含内容
| 路径 | 用途 |
|---|---|
assets/scaffold/ | 一个完整的、可构建的站点(经过类型检查和 next build 验证)。直接复制即可,无需重新输入。包含占位内容和工作设计系统。 |
assets/optional-sections/ | 来自原始站点的三个额外章节(前后对比、数据边界文件树、脚本墙)作为工作示例。未集成到主站点中。 |
scripts/accent.mjs | 为任何品牌色生成对比度安全的强调色变体。 |
scripts/capture.cjs | 通过离屏 Electron 窗口,以桌面端和手机端宽度截取运行中站点的截图,并按滚动步骤进行。 |
references/design-system.md | 设计令牌、主题、字体、间距、强调色对比度逻辑及其存在原因。在更改颜色或字体之前请先阅读。 |
references/section-patterns.md | 每个章节:它的用途、构建方式以及使其轻量化的技巧。在添加或重塑章节之前请先阅读。 |
references/motion-and-a11y.md | 运动预算、减少动画、无 JavaScript、触摸目标、水合陷阱。在添加任何动画或客户端代码之前请先阅读。 |
references/copy-and-facts.md | 语气、“单一场景”规则以及如何保持陈述真实。在撰写文案之前请先阅读。 |
references/verify.md | 在宣布站点完成之前需要运行的检查清单和命令。 |
工作流程
1. 收集输入信息(先看再问)
首先阅读产品的 README、包清单、定价/计划代码和发布工作流程;大多数答案都在那里。只询问用户无法找到的信息。你需要:
- 产品名称、一句话承诺、目标用户以及一个使其脱颖而出的特点。
- 平台、价格点和计划限制,每个都需要附上作为真实来源的文件。
- 一个品牌色(任意十六进制值),或选择颜色的权限。选择一个单一颜色并将其作为唯一的信号色。
- 是否有授权的显示字体。如果没有,脚手架中的开放许可替代字体(Instrument Serif)也可以。
- 需要哪些章节。默认设置:英雄区域、滚动条、工作原理、提问/演示、定价、常见问题、结尾、页脚。当产品有需要时,可以添加隐私、语言或前后对比章节。
- 站点位置。默认:产品仓库中的
website/文件夹,位于 npm workspaces 之外的独立包,以免影响应用的安装和锁文件。
2. 搭建脚手架
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
在编辑之前先运行一次构建,确保基线是绿色的。Mona Sans 在构建时从 Google Fonts 获取,然后由站点本身提供,因此首次构建需要网络。
3. 品牌化
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex>打印出--accent、--accent-display、扁平化的色调,以及按钮标签应该是深色还是白色。将这些放入app/globals.css(--brand、--brand-hover、--brand-tint、--accent、--accent-display),并替换app/icon.svg和app/opengraph-image.tsx中硬编码的#ff5e00/#e25300。- 在
components/Logo.tsx和Logo.module.css中重新绘制标志(占位符是四个声音条)。保持使用 div 或内联 SVG,绝不能使用位图。 - 设置
lib/site.ts中的SITE(名称、slug、文字标识、标题、导语、行动号召、备注)。slug还用于为localStorage中的货币偏好设置命名空间。
为什么使用脚本而不是目测:饱和的品牌色几乎无法在浅色页面上达到 4.5:1 的文本对比度,因此页面需要品牌色用于填充,以及一个更深色的版本来用于文本。猜测这个更深色版本正是站点出现对比度失败的原因。
4. 先有事实,后有文案
从产品自身的源文件填充 lib/site.ts(计划、平台、链接、常见问题),并将每个事实的来源记录在站点根目录的 README.md 文件中,标题为“事实来源”。将来源信息保存在 README 而不是代码注释中,以保持脚手架无注释。如果目标仓库或用户要求解释性注释,则遵循他们的要求。
然后阅读 references/copy-and-facts.md 并撰写文案。
5. 单一场景,处处共享
lib/demo.ts 包含一个单一的虚构场景,英雄区域模拟、产品故事和交互式演示都从中提取数据。将其替换为来自产品自身领域的场景(例如工单、拉取请求、日历、电子表格、会议)。由于每个章节读取相同的数据,页面永远不会自相矛盾,并且演示可以诚实地展示产品的真实约定(例如,每个声明都引用其来源)。
6. 章节
从脚手架的九个章节开始。对于每个章节,决定:它承载什么单一理念?哪个单一视觉元素能够证明它,而不是仅仅描述它?阅读 references/section-patterns.md。遵循章节语法:
- 标签芯片(
.label,带有data-scramble),然后是一个h2.display.h2,最后几个词放在.em中,然后是一个可选的.lead - 章节交替使用
data-theme="light"/"paper",这样每个章节都从颜色边缘开始,而不是从分割线开始 - 每个视口一个填充按钮;其他所有内容都是带品牌下划线的文本链接
- 产品模拟使用
data-theme="dark"和 px 尺寸,因为它们代表(深色)应用的截图。如果应用是浅色的,则将模拟设为浅色。
7. 验证
遵循 references/verify.md。简而言之:类型检查、构建、使用 scripts/capture.cjs 在 1440 和 390 宽度下截图、检查截图、按滚动步骤确认揭示效果触发、检查减少动画和无 JavaScript 情况、对任何新文本颜色重新运行 accent.mjs --check。如实报告未验证的内容,而不是暗示已通过。
不可妥协项及其原因
- 默认使用服务器组件;客户端孤岛仅用于行为。 页面是无 JavaScript 也能工作的静态 HTML,水合成本极低。孤岛写入
data-*属性或 CSS 变量,让 CSS 完成视觉工作。 - 组件仅使用语义令牌。 组件读取
--bg、--fg、--accent;章节的data-theme会交换它们。这就是同一个组件无需修改即可放置在画布、白色、色调或深色模拟上的方法。 - 文本尺寸用 rem,模拟用 px。 读者的浏览器文本大小必须适用于页面;模拟是截图的替代品。
- 暗淡文本通过颜色暗淡,而不是通过透明度。 透明度会悄无声息地将对比度降至 4.5:1 以下。
- 文案绝不能超出产品现状。 没有未发布的平台、不存在且有效的支持地址、如果音频流式传输到服务器则不能说“数据不会离开你的设备”。过度承诺的营销页面是一个 bug。
- 没有内置的动画暂停控件。 循环动画会为
prefers-reduced-motion停止。Kesami 的设计评审故意拒绝了暂停控件,因此脚手架中没有;如果用户需要,可以提供一个。
扩展脚手架
使用相同的原语创建新章节,而不是导入库:使用 CSS 自定义属性表示状态、每个行为使用一个 IntersectionObserver、使用 details/summary 进行展开、使用 position: sticky 实现滚动叙事、使用 @property 动画化变量。如果你发现自己打算使用 framer-motion 或轮播包,请先重新阅读 references/motion-and-a11y.md;答案几乎总是一个 CSS 变量和一个属性。