網站建立器
工作流程
1. 評估專案
判斷專案類型並選擇技術棧:
| 訊號 | 技術棧 | 部署目標 |
|---|---|---|
| 行銷網站、作品集、簡單頁面 | Vanilla 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
在所有元件中一致地套用品牌資產(標誌、顏色、字型)。關於調色板建構模式,請參閱 references/design_tokens.md。關於健康/電子商務設計靈感(Serene Herbs、Magic Mind 風格),請參閱 references/design_inspiration.md。
3. 建構元件
靜態網站:以區塊為單位、行動優先建構。每個區塊獨立包含其樣式。
React/Next.js 應用程式:以元件為優先的架構。從原子 → 分子 → 有機體 → 頁面依序建構。
Shopify 主題:以 Liquid 區塊的形式建構,並包含 {% schema %} 區塊,以便在主題自訂器中編輯。關於 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) - Richtext 欄位 — HTML 標籤上不可使用
style屬性;僅允許語意化 HTML - 配色方案 — 命名為
scheme-1到scheme-5(而非background-1) - image-with-text — 內容使用區塊(heading、text、button),而非區段層級的設定
- template_suffix 安全性 — 變更後綴會影響所有主題;務必先將備用模板推送到現行主題
- 速率限制 — 在 API 呼叫之間加入
time.sleep(0.5)
完整的 Shopify 參考資料與範例:references/shopify_2_0.md