文档首页
Landing 架构总览
说明这套 Astro landing page 如何拆分内容、交互与转化,同时保持默认 payload 足够轻。
Landing 架构总览
这个 starter 把营销站点视作一个 content-first system,并且只在局部引入真正必要的交互。
先把 narrative 结构和语义化 HTML 搭稳,再把动画预算和 hydration 预算投到确实能提高理解效率的区域。
这套技术栈里有什么
- Astro 负责 narrative shell 和大部分静态 section。
- React islands 只留给 AI demo、交互卡片和少量重交互 surface。
- Tailwind v4 tokens 与自定义 component classes 负责视觉系统一致性。
- Astro Actions 处理表单收集的服务端边界。
- Bun 与 Biome 负责依赖、脚本、lint 和格式化。
三层模型
整个实现被刻意拆成三层:
- Narrative layer:Hero 文案、证据模块、SEO metadata 和 docs。
- Interaction layer:React islands 与少量高价值动画。
- Capture layer:semantic form、校验与提交链路。
如果你想先看交付链路,可以继续看 交付模型。
如果你想看文档系统本身,可以继续看 文档系统。
默认路由是英文。中文内容放在
/zh/*下,/en/*只是为兼容性保留的轻量 redirect。