Communitygithub.com

nicolas2601/router-skills

适用于 Apple/Stripe/Sony Bravia 风格的高级落地页完整模板,包含 9 个类型化区块(液态玻璃导航、滚动擦洗画布、非对称卡片网格等)。强制技术栈:Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion + lucide-react + @fontsource。触发关键词:电影级落地页、Apple 风格、滚动擦洗视频、画布 Hero、Awwwards 级别落地页。

router-skills 是什么?

该技能提供一个高度规范的落地页模板,专为构建类似 Apple、Stripe 或 Sony Bravia 的顶级电影级营销页面而设计。它强制使用一套固定的现代技术栈(Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion),并规定了九个特定区块的精确实现模式,包括液态玻璃导航栏、基于滚动擦洗的 Canvas Hero、非对称 Bento 网格服务展示、带视频背景的统计模块以及双行跑马灯推荐模块。模板包含了详细的 CSS 设计令牌、液态玻璃 CSS 工具类以及五种核心动画原语(模糊文本、淡入、滚动擦洗、跑马灯、液态玻璃边框),并附有 15 条严格的“反草率”规则,以确保代码质量和视觉一致性。它还提供了帧提取流水线(ffmpeg)、性能检查清单以及 lighthouse 性能目标,适用于在 Vercel 等平台上的专业部署。该文档面向使用 AI 编码助手(如 Claude Code、Cursor)的开发者,指导他们生成符合 Awwwards 标准、无低级错误、可直接交付的落地页代码。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nicolas2601/router-skills/tree/HEAD/skills/cinematic-landing-template

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

电影级落地页模板

用于构建高级落地页的规范模板,核心功能为滚动擦洗画布 Hero。灵感来源于 Apple AirPods Pro、Stripe、Sony Bravia。

强制技术栈(不可替换)

npm create vite@latest . -- --template react-ts
npm install
npm install -D tailwindcss@next @tailwindcss/vite @tailwindcss/postcss autoprefixer
npm install motion lucide-react
npm install @fontsource/{display-font} @fontsource/{body-font}
npx shadcn@latest init -d
npx shadcn@latest add button accordion

文件结构

src/
  App.tsx
  main.tsx
  index.css                  # 设计令牌 + Tailwind @theme + 液态玻璃工具类
  components/
    ScrubSequence.tsx        # 画布帧渲染器(关键)
    BlurText.tsx             # 逐词模糊标题(关键)
    Navbar.tsx               # 浮动液态玻璃药丸导航
    Hero.tsx                 # 滚动擦洗画布 + 标题 + 行动按钮
    ServicesBento.tsx        # 6 卡非对称 Bento 网格
    Pourquoi.tsx             # 4 列为何选择我们网格
    Process.tsx              # 3-4 步编号水平流程
    Stats.tsx                # 视频背景 + 4 个计数动画统计
    Testimonials.tsx         # 2 行反方向跑马灯推荐
    Faq.tsx                  # 2 列布局(固定标题 + 手风琴)
    CtaFooter.tsx            # 电影级视频背景 + 行动按钮 + 页脚栏
    ui/
      button.tsx             # 包含 hero、heroGlass、heroSolid 变体
      accordion.tsx
  lib/
    utils.ts
    constants.ts             # FRAME_COUNT、FRAMES_PATH、FRAME_EXT
public/
  frames/                    # frame_0001.jpg ... frame_NNNN.jpg

九个区块 — 强制模式

1. 导航栏(浮动液态玻璃药丸)

  • fixed top-4 left-1/2 -translate-x-1/2 z-50 配合 liquid-glass rounded-full px-2 py-2
  • 3 个区域:Logo+品牌(左)| 导航链接(中,md 以上)| 行动按钮(右)
  • 滚动 > 40px:top-4 → top-2 + backdrop-blur-xl
  • 移动端:汉堡菜单 + 全屏液态玻璃抽屉

2. Hero(滚动擦洗画布)

  • <section ref={scrollRef} className="relative h-[250vh]">(250vh 提供帧序列滚动空间)
  • <div className="sticky top-0 h-screen overflow-hidden"> 用于固定
  • Canvas 绝对定位 inset-0 z-0
  • 径向渐变 Vignette z-1
  • 底部渐变淡出 z-2 过渡到下一区块
  • 内容(Badge + BlurText H1 + 副标题 + 行动按钮 + 合作伙伴跑马灯)z-10

3. 服务 Bento(非对称 6 卡)

  • 网格 md:grid-cols-3 gap-5
  • 卡片 0:高大 row-span-2
  • 卡片 1-2:小型
  • 卡片 3:宽 col-span-2
  • 卡片 4:小型
  • 卡片 5:全宽 col-span-3
  • 每张卡片:liquid-glass rounded-2xl + 图标在 liquid-glass-strong rounded-full size-11 + 展示标题 + 38ch 正文 + 右上角 ArrowUpRight 图标

4. 为何选择我们(4 列)

  • 网格 lg:grid-cols-4 gap-5 mt-16
  • 每张卡片:液态玻璃 + 图标 + 展示标题 + 30ch 正文 + 底部强调线

5. 流程(编号水平)

  • md:grid-cols-4 gap-0(gap-0 是因为连接线填补间隙)
  • 巨大编号 text-[140px] text-primary/25 重叠
  • 水平连接线:absolute top-20 -right-0 h-px w-full bg-gradient-to-r from-border via-border to-transparent

6. 统计(视频背景 + 计数动画)

  • 视频背景 filter saturate(0) 去色
  • 顶部和底部 200px 渐变淡出
  • 中央液态玻璃卡片 rounded-3xl p-14
  • 4 个统计:数值 font-display italic text-7xl + 标签 uppercase tracking-wide text-sm
  • 使用 motion 在进入视口时从 0 开始计数动画

7. 推荐(2 行跑马灯)

  • 第 1 行:animate-[marquee_28s_linear_infinite]
  • 第 2 行:animate-[marquee-rev_32s_linear_infinite](反方向)
  • 遮罩:[mask-image:linear-gradient(to_right,transparent,black_8%,black_92%,transparent)]
  • 悬停暂停:hover:[animation-play-state:paused]

8. FAQ(2 列布局)

  • 网格 md:grid-cols-[0.9fr_1.1fr] gap-16
  • 左侧:固定 md:sticky md:top-24 包含 Badge + 展示标题 + 段落 + 按钮
  • 右侧:shadcn Accordion 带样式化项目

9. 行动按钮 + 页脚

  • 视频背景 filter brightness(0.55)(此处 NO saturate-0,与统计区块不同)
  • 标题 font-display italic text-[180px](此处 NO uppercase — italic 是另一种风格)
  • 页脚:border-top + 版权 + 页脚链接

设计令牌(index.css)

@import "@fontsource/{display-font}/400.css";
@import "@fontsource/{display-font}/700.css";
@import "@fontsource/{body-font}/400.css";
@import "tailwindcss";

:root {
  /* 原始调色板 HSL 三元组(无 hsl() 包装,以支持 Tailwind 中的 alpha 值) */
  --ink:    20 15% 9%;
  --cream:  40 30% 90%;
  --ochre:  32 55% 65%;
  --terra:  14 55% 31%;

  /* 语义化 */
  --background: var(--ink);
  --foreground: var(--cream);
  --primary: var(--ochre);
  --secondary: var(--terra);
  --muted: 240 4% 16%;
  --muted-foreground: 40 6% 72%;
  --border: 40 30% 90% / 0.18;
  --ring: var(--ochre);
  --radius: 0.75rem;

  /* 排版 */
  --font-display: "Oswald", "Impact", sans-serif;
  --font-body: "Inter", -apple-system, sans-serif;

  /* 布局 */
  --gutter: clamp(20px, 4.2vw, 56px);
  --max: 1440px;
}

@theme {
  --color-background: hsl(var(--background));
  --color-foreground: hsl(var(--foreground));
  --color-primary: hsl(var(--primary));
  /* ... 其余语义化令牌 */
  --animate-marquee: marquee 28s linear infinite;
  --animate-marquee-rev: marquee-rev 32s linear infinite;
}

@keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }
@keyframes marquee-rev { from { transform: translateX(-50%) } to { transform: translateX(0) } }

液态玻璃工具类(@layer components)

.liquid-glass {
  background: rgba(255,255,255,0.01);
  background-blend-mode: luminosity;
  backdrop-filter: blur(4px);
  border: none;
  box-shadow: inset 0 1px 1px rgba(255,255,255,0.1);
  position: relative;
  overflow: hidden;
}
.liquid-glass::before {
  content: '';
  position: absolute;
  inset: 0;
  border-radius: inherit;
  padding: 1.4px;
  background: linear-gradient(180deg,
    rgba(255,255,255,0.45) 0%, rgba(255,255,255,0.15) 20%,
    rgba(255,255,255,0)    40%, rgba(255,255,255,0)    60%,
    rgba(255,255,255,0.15) 80%, rgba(255,255,255,0.45) 100%);
  -webkit-mask: linear-gradient(#fff 0 0) content-box, linear-gradient(#fff 0 0);
  -webkit-mask-composite: xor;
          mask-composite: exclude;
  pointer-events: none;
}
.liquid-glass-strong { /* 同上但 blur(50px) + 更强的 box-shadow */ }

动画 — 5 种原语(不要发明新动画)

  1. BlurText(标题):逐词间隔 0.07s,每词持续时间 0.7s,缓动 [0.22, 1, 0.36, 1]
  2. Fade-up-on-view(副文本、行动按钮):initial={{opacity:0, y:16, filter:"blur(8px)"}},whileInView={{opacity:1, y:0, filter:"blur(0)"}},viewport={{once:true, amount:0.3}}
  3. 滚动擦洗画布(仅 Hero):Apple AirPods Pro 模式。参见 scroll-scrub-canvas 技能。
  4. 跑马灯(合作伙伴、推荐):28s/32s 反方向,渐变遮罩边缘,悬停暂停
  5. 液态玻璃 ::before 边框(卡片、药丸、按钮):绝对不要用常规 CSS border 替代

反草率护栏(15 条规则 — 提交前阅读)

  1. 任何地方不要使用 emoji(文案、卡片、按钮都不用)
  2. 不要使用紫色/蓝色的默认渐变(调色板是暖色:赭石 + 赭色 + 奶油色 + 墨色)
  3. 卡片上不要使用 shadow-2xl(深度感来自背景模糊,而非投影)
  4. 按钮不要使用 rounded-3xl → 按钮 rounded-full,卡片 rounded-2xl
  5. 不要遗留 lorem ipsum 占位符(使用 [TODO: {{PLACEHOLDER}}] 使其可见)
  6. 正文段落不要使用 text-center(Hero 和 CTA 除外——它们自成一体)
  7. 标题:font-display uppercase tracking-tight 或 font-display italic(同一元素中绝不同时使用)
  8. 每个区块:Badge + 标题 + 副文本模式(Hero 和页脚除外)
  9. 仅使用 lucide-react 图标(不要用 heroicons、Material 或自定义 SVG,除非用户提供)
  10. Hero 不要使用 <video> —— Hero 是 canvas。<video> 只用于 Stats 和 CTA 背景。
  11. 不要使用 motion.div 配合 transition={{ duration: > 0.9 }}
  12. 不要有 console.log、注释代码、空文件、未使用的 import
  13. 文案使用 {{LANG}} —— 不要自动翻译占位符
  14. 响应式:1440 桌面画布,375px 移动端(iPhone SE)无水平滚动
  15. 无障碍:focus-visible:ring-2 ring-ring offset-2 offset-background,canvas aria-hidden,sr-only 同级元素描述视频

交付前验证

npm run dev   # 启动无错误
npm run build # 0 个 TypeScript 错误,0 个 Vite 错误

# 视觉检查:
# - Hero 首次绘制 < 300ms(优先预加载 frame_0001)
# - 擦洗无卡顿 > 50ms
# - 跑马灯循环无缝(重复数组,中点不可见)
# - FAQ 手风琴高度过渡平滑
# - 导航栏在滚动 > 40px 时从 top-4 变为 top-2
# - 375px 无水平溢出

# 控制台:
# - 0 个 React 警告
# - 0 个帧 URL 404 错误

# 性能:
# - Lighthouse 性能 ≥ 85
# - LCP < 2.5s(使用 <link rel="preload"> 预加载 frame_0001)

帧提取流水线

mkdir -p input public/frames

ffmpeg -i input/source.mp4 \
  -vf "fps=30,scale='min(1920,iw)':'-2':flags=lanczos" \
  -q:v 3 \
  public/frames/frame_%04d.jpg

ls public/frames | wc -l  # 粘贴到 FRAME_COUNT

WebP 可选(约减小 40%):

for f in public/frames/*.jpg; do
  cwebp -q 82 "$f" -o "${f%.jpg}.webp" && rm "$f"
done

如果总大小 > 20MB 且部署在 Vercel hobby 计划(25MB 限制):发出警告并建议使用外部 CDN。

资源

相关技能