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孤岛(island)**中 — React 上下文不会在多个 Astro 孤岛之间共享。 - 对于需要按钮样式的链接,优先使用
<a class={buttonVariants(...)}>而不是水合(hydrated)的<button>组件。
Tailwind v4 + 共享 token(关键性修复)
- Tailwind v4 通过
@tailwindcss/vite在astro.config.mjs中配置(旧的@astrojs/tailwind集成已弃用)。 src/styles/global.css导入了共享主题,并且添加了 Astro 内容源:共享的@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.css只会扫描.ts/.tsx文件,因此如果没有添加@source,在.astro标记中编写的工具类永远不会被生成(它们会静默地不生效)。- CSS 注释陷阱: 如果 CSS 注释中包含
**/这样的 glob 模式(例如描述apps/**/*),会导致注释提前闭合(因为*/),从而破坏后续的规则。请避免在注释中使用 glob 模式。
动态数据(必要时)
- 落地页没有 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)应通过检查。