Landing (Astro)
apps/landing 是一個靜態 Astro 網站,它重複使用 @workspace/ui(shadcn / Tailwind v4)以維持品牌一致性,且幾乎零客戶端 JS。
使用時機
- 任何在
apps/landing下的變更:區段、元件、樣式,或新增動態資料。
不使用時機
- Next.js 應用程式或行動端 — 它們使用不同的執行環境。
零 JS 模型
- Astro 預設在建置時將 React 元件渲染成靜態 HTML。以展示為目的使用 shadcn 元件(
<Button>、<Card>、<Badge>)不會傳送任何客戶端 JS。 - 只有當您加上
client:*指令(client:load、client:visible)時,JS 才會被傳送。請僅在真正需要互動的元件上使用它,並將這些互動元件集中在單一個.tsx島嶼內 — React 的 Context 在獨立的 Astro 島嶼之間是無法共享的。 - 對於樣式為按鈕的連結,請優先使用
<a class={buttonVariants(...)}>而非水合的按鈕元件。
Tailwind v4 + 共享權杖(關鍵修正)
- Tailwind v4 是透過
astro.config.mjs中的@tailwindcss/vite設定的(舊的@astrojs/tailwind整合已棄用)。 src/styles/global.css匯入了共享主題,並新增了一個 Astro 內容來源:共享的@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.css僅掃描.ts/.tsx,因此若沒有加上@source,在.astro標記中撰寫的工具類別將永遠不會被產生(它們會默默地不生效)。- CSS 註解陷阱: 一個包含
**/全域模式的 CSS 註解(例如描述apps/**/*)會提前關閉註解(因為*/),導致後續的規則損毀。請將全域模式排除在註解之外。
動態資料(必要時)
- 登陸頁面沒有 React Provider,也沒有 WorkOS 驗證。若需要表單或動態呼叫,請使用 Astro 伺服器端點配合
convex/browser中的ConvexHttpClient來進行一次性變異或查詢 — 請勿使用ConvexReactClient或ConvexProviderWithAuth。
注意事項
- 匯入完整的
@workspace/ui/globals.css會引入額外的主題變數與動畫 — 沒關係(Tailwind 會搖樹移除未使用的工具類別)。 - 此處沒有
next-themes,因此登陸頁面僅支援淺色模式,除非您新增一個小型內聯的.dark切換腳本。 next/font不可用 — 請使用@fontsource/*或<link>來達到精確的字體一致性。
驗證
pnpm --filter landing build→ 靜態的dist/目錄;對於沒有使用client:*的頁面,index.html中沒有<script>標籤。- 僅在
.astro檔案中使用的類別(例如bg-primary)會出現在建置後的 CSS 中(表示@source修正生效)。 pnpm --filter landing typecheck(astro check)通過。