使用時機
- 使用者想要一個新的登陸頁面(產品、服務、活動、作品集、等候名單)
- 使用者想要重新設計現有的登陸頁面,使其看起來專業且獨特
- 使用者要求動畫、滾動效果或行銷頁面上的微互動
- 使用者正處於規劃階段:討論需要哪些區塊、傳達什麼訊息、採用什麼結構
技術棧(與選擇理由)
| 項目 | 選擇 | 理由 | 已淘汰的替代方案 |
|---|---|---|---|
| 框架 | Astro 5 | 預設靜態(基礎 JS 為 0)、元件化、支援 astro:assets 處理圖片、部署只需上傳 dist/ | Next.js(對登陸頁來說過於複雜,部署較麻煩)、純 HTML(缺乏元件與優化) |
| 樣式 | Tailwind CSS v4 | 透過 CSS 的 @theme 使用自有 Token,無需 JS 設定檔,自動清除未使用樣式 | UI 套件(shadcn/DaisyUI/Flowbite → 看起來像樣板)、純 CSS(迭代速度慢) |
| 動畫 | GSAP 3.13+(ScrollTrigger, SplitText) | 業界滾輪/時間軸動畫標準;從 v3.13 起所有外掛皆免費 | Framer Motion(綁定 React)、AOS(功能有限,容易看出是套件) |
| 平滑滾動 | Lenis | 輕量(約 4kb),與 ScrollTrigger 有完善整合文件 | Locomotive Scroll(較重,維護較少) |
| 部署 | Netlify / Cloudflare Pages / Vercel | 連接儲存庫 → 推送 → 部署;靜態輸出,無需伺服器 | VPS(對靜態網站來說沒必要) |
嚴格規則:不要安裝任何 UI 元件庫。設計必須是原創的——這正是此技能與模板的區別所在。
工作流程(必須按此順序執行)
絕對不要從程式碼開始。未經簡報的登陸頁不過是換了名字的模板。
- 簡報 — 與使用者一起完成 assets/brief-template.md。如果缺少目標、受眾或主要行動呼籲(CTA):在繼續前提問。
- 設計方向 — 遵循 references/design-direction.md:個性 → 字體 → 顏色 → 佈局 → 視覺簽名。將結果落實到 assets/design-tokens.css。
- 區塊架構 — 定義敘事弧(見下方表格)以及標題文案,然後再進行佈局。
- 建置 — 逐個區塊建置,行動優先(先從 390px 開始)。動畫遵循 references/animation-recipes.md。
- 稽核 — 完成交付檢查清單(如下)。未通過檢查不得交付。
- 部署 — 靜態建置 + 託管(命令如下)。
敘事弧(基本結構)
| # | 區塊 | 作用 |
|---|---|---|
| 1 | 主視覺區 (Hero) | 在 5 秒內傳達價值主張 + 主要行動呼籲 |
| 2 | 問題/情境 | 點出訪客能認同的痛點 |
| 3 | 解決方案/好處 | 說明你如何解決問題——強調好處,而非功能 |
| 4 | 社會證明 | 真實推薦、客戶標誌、數據指標 |
| 5 | 運作方式 | 步驟、展示、螢幕截圖 |
| 6 | 異議處理 | 常見問題、保證、價格 |
| 7 | 最終行動呼籲 | 重複主視覺區的「同一個」獨特行動 |
根據簡報調整、合併或刪除區塊——並非所有登陸頁都需要這七個區塊。
關鍵模式
- 單一轉換目標:整個頁面都導向「一個」行動。兩個不同的行動呼籲代表簡報沒做好。
- 真正的行動優先:設計與建置先以 390px 為基準;桌面版是延伸,而非反過來。
- LCP 不可觸碰:LCP 元素(主視覺區的標題或圖片)永遠不能在 CSS 中設置
opacity: 0。進場動畫使用gsap.from()(沒有 JS 時頁面應完整顯示),且總時長 ≤ 1 秒。 prefers-reduced-motion:所有動畫都必須放在gsap.matchMedia()中。沒有例外。- 最小化 Islands:JavaScript 僅用於實際互動的地方。常見問題的摺疊式選單用
<details>標籤,而不是一個會 hydration 的元件。 - 圖片:一律使用
astro:assets(<Image>元件)、AVIF/WebP 格式、設定明確尺寸、loading="lazy"(主視覺區圖片除外)。 - 字體:自行託管(本機 woff2 或 Fontsource)、
font-display: swap、最多兩個字體家族、預載顯示用字體。
交付前檢查清單
- 行動版 Lighthouse ≥ 95 效能、可及性與 SEO
- CLS = 0(圖片設定尺寸、字體回落(fallback)已調整)
- 在
prefers-reduced-motion: reduce時停用動畫 - 對比度 AA 標準:文字 4.5:1,大型 UI 3:1
- 可鍵盤導航、焦點可見、只有一個
h1 - Meta 描述、OG 標籤、favicon、唯一標題
- 已於 390px、768px 和 1440px 測試
- 品牌測試:遮住 Logo,頁面看起來像其他公司的嗎?如果是 → 回到階段 2
命令
# 創建專案
pnpm create astro@latest mi-landing -- --template minimal --typescript strict
cd mi-landing
pnpm astro add tailwind
pnpm add gsap lenis
# 開發與建置
pnpm dev
pnpm build && pnpm preview
# 部署(擇一;在 Netlify/Vercel/Cloudflare 上:建置指令 "pnpm build",輸出目錄 "dist")
npx wrangler pages deploy dist # 直接部署至 Cloudflare Pages
npx netlify deploy --prod --dir=dist # 直接部署至 Netlify
資源
- 模板:assets/brief-template.md — 規劃問卷;assets/design-tokens.css — 自有設計系統基礎(Tailwind v4
@theme) - 指南:references/design-direction.md — 反模板的藝術指導;references/animation-recipes.md — 可直接套用的 GSAP/ScrollTrigger/Lenis 動畫配方