网站构建器
工作流
1. 评估项目
确定项目类型并选择技术栈:
| 信号 | 技术栈 | 部署平台 |
|---|---|---|
| 营销网站、作品集、简单页面 | 纯 HTML/CSS/JS 或 Astro | Netlify |
| 含认证、API、数据库的动态应用 | Next.js + Tailwind | Vercel |
| Shopify 商店页面(产品、集合、主页) | Liquid + JSON 模板 | Shopify API |
| 内容密集型博客/文档 | Astro + MDX | Netlify |
有关详细的技术栈选择标准,请参见 references/stack_guide.md。
2. 建立设计系统
在编写任何组件之前,先定义设计令牌:
颜色: primary, secondary, accent, neutral (50-900), success, error
排版: 标题字体、正文字体、字号比例(xs 到 4xl)
间距: 4px 基础单位(4, 8, 12, 16, 24, 32, 48, 64)
圆角: sm (4px), md (8px), lg (12px), full
阴影: sm, md, lg
在所有组件中一致地应用品牌资产(Logo、颜色、字体)。有关调色板构建模式,请参见 references/design_tokens.md。有关健康/电商设计灵感(Serene Herbs, Magic Mind 风格),请参见 references/design_inspiration.md。
3. 构建组件
静态站点:逐区块构建,移动端优先。每个区块是自包含的,并带有自己的样式。
React/Next.js 应用:组件优先架构。按原子 → 分子 → 有机体 → 页面的顺序构建。
Shopify 主题:构建为带有 {% schema %} 块的 Liquid 区块,以支持 Theme Customizer 编辑。有关 Shopify 特定的模式、易错点和部署,请参见 references/shopify_2_0.md。
4. 部署
Netlify(静态站点):
npx netlify-cli deploy --prod --dir=./dist
Shopify(Liquid 区块 + JSON 模板): 使用捆绑脚本通过 Admin API 推送:
scripts/deploy_shopify_section.py— 推送.liquid区块文件scripts/deploy_shopify_template.py— 推送 JSON 模板并分配产品
Vercel(Next.js):
npx vercel --prod
有关部署细节和安全模式,请参见 references/deployment.md。
Shopify 快速参考
Shopify 是最容易出错的技术栈。关键易错点:
- 区块类型 — 使用主题的实际区块类型名称(例如
title而不是@app/title) - 富文本字段 — HTML 标签上不允许出现
style属性;仅使用语义化 HTML - 配色方案 — 命名为
scheme-1到scheme-5(而不是background-1) - image-with-text — 内容使用区块(heading, text, button),而不是区块级别的设置
- template_suffix 安全性 — 更改后缀会影响所有主题;始终先向在线主题推送一个回退模板
- API 限流 — 在 API 调用之间添加
time.sleep(0.5)
包含示例的完整 Shopify 参考:references/shopify_2_0.md