產品著陸頁面
一個從 Kesami 行銷網站萃取的配方,用於建立一個看似精心設計而非套用樣板的單一靜態頁面,並能經得起檢驗:經過對比檢查、支援鍵盤操作、對產品誠實、載入快速。
結果是一個由伺服器渲染的各區段組成的 Next.js 頁面。互動僅限於幾個小型 client islands,這些 islands 會切換 DOM 屬性或 CSS 變數,而非重新渲染。沒有 UI 函式庫、沒有 Tailwind、沒有動畫函式庫。
附帶內容
| 路徑 | 用途 |
|---|---|
assets/scaffold/ | 一個完整、可建置的網站(已通過型別檢查和 next build 驗證)。請複製它,不要重新輸入。包含佔位內容與可運作的設計系統。 |
assets/optional-sections/ | 三個來自原始網站的額外區段(前後對比、資料邊界檔案樹、腳本牆),作為實際範例。未接線。 |
scripts/accent.mjs | 為任何品牌顏色推導出安全的對比強調色陰影。 |
scripts/capture.cjs | 透過離屏 Electron 視窗,以桌面和手機寬度對運行中的網站進行截圖,並逐步記錄滾動過程。 |
references/design-system.md | Token、主題、字體、間距、強調對比邏輯及其存在原因。變更顏色或字體前請先閱讀。 |
references/section-patterns.md | 每個區段的說明:用途、建構方式、使其輕量的技巧。新增或調整區段前請先閱讀。 |
references/motion-and-a11y.md | 動畫預算、減少動畫偏好、無 JavaScript 支援、觸控目標、hydratation 陷阱。新增任何動畫或用戶端程式碼前請先閱讀。 |
references/copy-and-facts.md | 語氣、單一情境規則、以及如何保持聲明真實。撰寫文案前請先閱讀。 |
references/verify.md | 在宣稱網站完成前需執行的檢查清單與指令。 |
工作流程
1. 收集輸入(先觀察再提問)
首先閱讀產品的 README、套件清單、定價/方案程式碼和發佈工作流程;大部分答案都在那裡。僅詢問用戶無法找到的資訊。你需要:
- 產品名稱、一句話承諾、目標受眾,以及其與眾不同的一點。
- 平台、價格點和方案限制,每個都需附上其真理來源的檔案。
- 品牌顏色(任何十六進位色碼),或允許自行挑選一個。選擇單一顏色並將其作為唯一的信號色。
- 是否有授權的顯示字體。若無,則使用藍圖中的開放授權替代字體 (Instrument Serif)。
- 適用哪些區段。預設組合:Hero、跑馬燈、運作方式、問答/展示、定價、常見問題、結尾、頁尾。當產品有需要某個區段的故事時,才添加隱私保護、語言或前後對比區段。
- 網站放置的位置。預設為產品儲存庫中的
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、字標、標題、導語、CTA、備註)。slug也為 localStorage 中的貨幣偏好設定命名空間。
為什麼要使用腳本而非目測:飽和的品牌顏色幾乎永遠無法在淺色頁面上達到 4.5:1 的文字對比度,因此頁面需要品牌色用於填充,並需要一個更深的兄弟色用於文字。猜測這個兄弟色就是網站對比失敗的原因。
4. 先有事實,再有文案
從產品自己的原始檔中填入 lib/site.ts(方案、平台、連結、常見問題),並在網站的 README.md 中的「事實來源」部分記錄每個事實的來源。將出處保留在 README 中,而非程式碼註解,以保持藍圖無註解。如果目標儲存庫或用戶要求解釋性註解,則遵循該要求。
然後閱讀 references/copy-and-facts.md 並撰寫文案。
5. 單一情境,全站共享
lib/demo.ts 存放一個虛構的情境,Hero 模擬、產品故事和互動式展示都會從中提取資料。將它替換為來產品自身領域的情境(例如:支援工單、拉取請求、日曆、試算表、會議)。因為每個區段都讀取相同的資料,頁面永遠不會自相矛盾,而且展示可以誠實地展示產品的真實合約(例如,每個聲明都引用其來源)。
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。報告任何未驗證的項目,而不是暗示它們已通過。
不可協商事項及其原因
- 預設使用伺服器元件;僅在行為需要時才使用 client islands。 頁面是無需 JavaScript 即可運作的靜態 HTML,且 hydrate 成本極低。Islands 會寫入
data-*屬性或 CSS 變數,並讓 CSS 執行視覺工作。 - 元件中只使用語義化 token。 元件讀取
--bg、--fg、--accent;區段的data-theme會切換它們。這就是一個元件如何能在 Canvas、白色、色調或深色模擬上無需編輯即可放置的原因。 - 文字尺寸使用 rem,模擬使用 px。 讀者的瀏覽器文字大小必須應用於頁面;模擬是螢幕截圖的替代品。
- 暗淡的文字透過顏色而非透明度來實現。 透明度會悄悄地將對比度降至 4.5:1 以下。
- 文案絕不超出產品實際功能。 沒有未發佈的平台、不存在的支援地址、如果音訊串流到伺服器則不應聲稱「資料不出設備」。誇大其詞的行銷頁面就是一個錯誤。
- 不內建動畫暫停控制。 循環動畫會因
prefers-reduced-motion停止。Kesami 的設計審查故意拒絕了暫停控制,因此藍圖中沒有此功能;如果用戶想要,可以新增一個。
擴充藍圖
使用相同的基礎元件來創造新的區段,而不是匯入函式庫:使用 CSS 自訂屬性處理狀態、每個行為使用一個 IntersectionObserver、使用 details/summary 做為揭露元件、使用 position: sticky 做為滾動說故事、使用 @property 來做變數動畫。如果你發現自己需要 framer-motion 或輪播套件,請先重新閱讀 references/motion-and-a11y.md;答案幾乎總是 CSS 變數和一個屬性。