- AI 技能
- AI 插件
- 人工智能
【免费下载链接】agentic-awesome-skills
AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.
本文以 agentic-awesome-skills 仓库中
app-builder技能的nextjs-static项目模板为核心,系统讲解如何用 Next.js 14 静态导出 + TypeScript + Tailwind CSS + Framer Motion 搭建 Landing Page、个人作品集与营销站点。读完本文,你将掌握静态导出的完整配置、落地页区块的组织方法、动画模式的选择依据,以及一键部署到任意静态托管的完整流程。
该模板位于 plugins/agentic-awesome-skills-claude/skills/app-builder/templates/nextjs-static/TEMPLATE.md,是 app-builder 技能提供的 13 个项目模板之一。在技能编排体系中,当用户请求中出现portfolio、personal、cv、landing、promotional、marketing等关键词时,项目类型检测 会将其归类为「Portfolio / Landing Page」,并精确路由到本模板,只读取本模板文件即可开始搭建,无需加载其他模板。
技术栈选型
模板规定的技术栈如下:
| 组件 | 技术选型 |
|---|---|
| 框架 | Next.js 14(静态导出 Static Export) |
| 语言 | TypeScript |
| 样式 | Tailwind CSS |
| 动画 | Framer Motion |
| 图标 | Lucide React |
| SEO | Next SEO |
这套组合的核心设计意图非常明确:静态站点追求极致的首屏性能与部署简单性,因此刻意不引入数据库、认证等后端依赖。需要说明的是,仓库中 tech-stack.md 记录的 2025 默认 Web 栈是 Next.js 16 + Tailwind CSS v4 + React 19 Server Components + Turbopack;而本模板固定标注 Next.js 14,是因为output: 'export'静态导出模式在 14 版本已完全成熟稳定。如果你新建项目时使用更新版本的 Next.js,本模板的目录结构与导出配置依然适用。
- TypeScript:为模板中的
{{name}}占位符、路由与组件提供类型约束,配合路径别名减少深层相对导入; - Tailwind CSS:移动优先的原子化样式,模板中所有落地页区块均按 Tailwind 的响应式类组织;
- Framer Motion:负责入场、滚动显现与悬停动效,是模板强调「premium animations」的载体;
- Lucide React:轻量图标库,供 Hero、Features 等区块使用;
- Next SEO:为每个页面注入统一的
title、description、OG 标签等元信息。
目录结构设计
模板给出了一个精简、职责分明的目录骨架:
project-name/ ├── src/ │ ├── app/ │ │ ├── layout.tsx │ │ ├── page.tsx # Landing │ │ ├── about/ │ │ ├── contact/ │ │ └── blog/ │ ├── components/ │ │ ├── layout/ # Header, Footer │ │ ├── sections/ # Hero, Features, CTA │ │ └── ui/ │ └── lib/ ├── content/ # Markdown content ├── public/ └── next.config.js各部分的职责划分与仓库中 scaffolding.md 倡导的「薄路由 + 组件分层」理念一脉相承:
src/app/:Next.js App Router 路由层,layout.tsx定义全局布局(Header/Footer、字体、SEO 元信息),page.tsx是落地首页,about/、contact/、blog/是二级路由,各自拥有独立page.tsx;src/components/layout/:站点级框架组件(Header、Footer),全站复用;src/components/sections/:落地页的「段落级」组件,如 Hero、Features、CTA,每个区块一个文件,便于独立增删与调整顺序;src/components/ui/:可复用的基础 UI 组件(按钮、卡片、标签等),与 scaffolding.md 中shared/components/ui/的分层思路一致;content/:存放 Markdown 内容(如博客文章、案例内容),配合静态导出在构建期转为 HTML;public/:静态资源目录,favicon、logo、图片等无需经过打包直接引用;next.config.js:承载静态导出配置,见下一节。
静态导出配置:一行决定「纯静态」
模板给出的next.config.js是整个技术方案的关键:
// next.config.js const nextConfig = { output: 'export', images: { unoptimized: true }, trailingSlash: true, };三个配置项的含义与影响如下:
| 配置项 | 作用 | 说明 |
|---|---|---|
output: 'export' | 构建时生成纯静态 HTML/CSS/JS | 禁用所有 Node.js 运行时能力(无 API Routes、无 Server Actions、无 middleware),next build产物可直接由任意静态服务器托管 |
images: { unoptimized: true } | 关闭 Next.js 内置图片优化 | 静态导出模式下没有图片优化服务,必须关闭,否则next/image会在构建或运行时报错;同时意味着图片应自行压缩 |
trailingSlash: true | 生成/about/形式的路径 | 路径带尾部斜杠,对多数静态托管与 CDN 缓存更友好,避免目录重定向 |
配套的目录结构也隐含了静态站的数据策略:content/目录中的 Markdown 通过构建期的读取(例如在getStaticProps或 App Router 的generateStaticParams中读取)在构建时生成页面,运行期不再有服务端计算,这保证了任意主机上的一致表现。
落地页区块组织
模板将落地页划分为五个标准区块,构成一条完整的转化漏斗:
| 区块 | 目的 |
|---|---|
| Hero | 主标题(Main headline)+ CTA 按钮,用户的第一印象,决定首屏停留 |
| Features | 产品核心卖点/利益点列表 |
| Testimonials | 客户证言,提供社交证明(Social proof) |
| Pricing | 定价方案 |
| CTA | 最终转化行动点 |
在src/components/sections/下,每个区块对应一个组件(Hero.tsx、Features.tsx、Testimonials.tsx、Pricing.tsx、CTA.tsx),在page.tsx中按序组合。这种「区块即组件」的组织方式有两个实战优势:
- 顺序可调:调整区块顺序只需改
page.tsx中的组件排列,无需动区块内部逻辑; - 可复用:各区块也可被
about/、contact/等二级页面按需复用,避免重复实现。
动画模式:Framer Motion 四种用法
模板归纳了四种高频动画模式:
| 模式 | 适用场景 |
|---|---|
| Fade up(淡入上移) | 内容入场(Content entry),最通用的段落显现效果 |
| Stagger(错落) | 列表项(List items),如 Features 列表逐条依次显现 |
| Scroll reveal(滚动显现) | 进入视口时触发(On viewport),提升长页面的节奏感 |
| Hover(悬停) | 交互反馈(Interactive feedback),按钮、卡片、链接的悬停微动效 |
结合 Framer Motion 的 API,四种模式对应的实现要点为:
- Fade up:
motion.div配合initial={{ opacity: 0, y: 24 }}与whileInView/animate完成透明度与位移的入场; - Stagger:父容器使用
staggerChildren变体,子项设置各自的hidden/show变体,实现列表依次浮现; - Scroll reveal:使用
whileInView={{ opacity: 1 }}与viewport={{ once: true }},保证元素进入视口才显现,且只播放一次; - Hover:
whileHover={{ scale: 1.05 }}等属性提供即时的鼠标反馈。
动画应服务于转化而非分散注意力,模板将 Fade up / Scroll reveal 用于内容节奏、Hover 用于可交互元素,正是「premium animations」与可用性之间的平衡。
从零搭建:五步上手
模板给出了可直接执行的初始化流程:
创建项目(
{{name}}为项目名占位符,实际创建时替换为你的项目名):npx create-next-app {{name}} --typescript --tailwind --app--typescript启用 TypeScript,--tailwind预装 Tailwind CSS,--app使用 App Router,与模板目录结构完全对齐;安装依赖:
npm install framer-motion lucide-react next-seo配置静态导出:将上一节的
next.config.js写入项目根目录;创建区块:在
src/components/sections/下按落地页区块表逐个实现 Hero、Features、Testimonials、Pricing、CTA,并在page.tsx中组合;本地开发验证:
npm run dev在开发服务器中核对页面效果后,执行
npm run build确认静态导出产物生成于out/目录,再执行npx serve out(或任意静态服务器)本地验证产物行为。
部署:一次构建,随处托管
由于output: 'export'的产物是纯静态文件,部署矩阵覆盖所有主流静态托管方式:
| 平台 | 方式 |
|---|---|
| Vercel | 自动(Auto)识别静态导出并直接发布 |
| Netlify | 自动(Auto) |
| GitHub Pages | 推送到gh-pages分支 |
| 任意主机 | 上传out文件夹即可 |
值得说明的实践细节:
- Vercel / Netlify:连上 Git 仓库后平台自动检测 Next.js 项目并执行构建,
output: 'export'的项目会被当作纯静态站点发布,无需额外配置; - GitHub Pages:需要把构建产物
out/的内容部署到gh-pages分支(可配合 GitHub Actions 在 CI 中构建并推送); - 任意主机 / 对象存储:直接把
out/目录上传到 Nginx、Apache、S3 静态网站托管等,即可上线,无需 Node.js 运行时。
由于trailingSlash: true,部署时建议确认托管方对/about/这类带尾斜杠路径的映射一致,避免 404。
最佳实践清单
模板在结尾给出了四条工程质量准则,可视为本模板的验收标准:
- 静态导出换取最大性能:
output: 'export'让整站只有静态资源,首屏加载与缓存命中率达到静态方案的上限; - Framer Motion 提供高级动画:用声明式的动效提升品牌质感,但保持克制、以转化目标为准;
- 移动优先的响应式设计:所有区块按 Tailwind 的
sm:/md:/lg:断点自移动端向上构建; - 每个页面都有 SEO 元数据:借助 Next SEO 为
layout.tsx与每个路由设置title、description、OG 标签,确保落地页在搜索结果与社交分享中呈现良好。
此外,结合 app-builder 技能的整体约束,使用本模板时还需注意:模板适用于与 Landing Page / 作品集 / 营销页明确匹配的任务;产物上线前仍需经过环境验证、测试与专家评审,模板输出不能替代针对具体环境的校验。
小结
nextjs-static是 agentic-awesome-skills 仓库中面向「落地页 / 作品集 / 营销站点」场景的精简模板:用 Next.js 14 静态导出保证性能与部署自由度,用 Framer Motion + Tailwind CSS 支撑视觉与动效,用五个标准区块覆盖完整转化漏斗。当你向 app-builder 发起landing、portfolio或marketing类需求时,技能会自动路由到本模板,按「创建项目 → 装依赖 → 配导出 → 建区块 → 开发验证」五步即可在几分钟内得到可部署到任意静态托管的站点。
- AI 技能
- AI 插件
- 人工智能
【免费下载链接】agentic-awesome-skills
AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.
相关推荐
基于 Next.js 14 静态导出模板构建高性能落地页与营销站点(Dillinger 实践指南)
基于 Next.js 14 静态导出模板构建高性能落地页与营销站点(Dillinger 实践指南) 本文以仓库内 .agent/skills/app build
前端开发工具Next.js 静态导出(Static Export)实战指南:以 with-static-export 示例构建纯静态站点
Next.js 静态导出(Static Export)实战指南:以 with static export 示例构建纯静态站点 在 Next.js 中开启静态导出
前端Web框架SSR后端如何用 ipatool 从 App Store 下载 IPA 文件:认证、取包、拿历史版本一次讲清
如何用 ipatool 从 App Store 下载 IPA 文件:认证、取包、拿历史版本一次讲清 想分析某个 App 的某个旧版本,却发现手机里只能装到最新版
CLI
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考