如何使用设计文档

设计文档是这份模板的设计契约。它写明了主题方向、源文件、颜色令牌、排版、布局规则、暗色模式、动效和组件模式。

自定义模板时,先读设计文档再改组件。它能帮你避免各个页面的视觉细节各自为政。

推荐工作流

  1. 使用项目元数据更新 src/config/site.js
  2. src/styles/global.css 中调整基础品牌令牌,在 src/styles/themes.css 中调整非默认主题覆盖。
  3. 查看 /elements 了解视觉效果。
  4. 如果更改了系统规则,更新 docs/DESIGN.md
  5. 使用现有组件构建新页面。

保持更新

主题有变动时,在同一个 PR 里同步更新设计文档。它不只是项目文档,更是后续贡献者保持网站视觉一致性的依据。

Logo

设计驱动的 Astro 启动模板,自带博客、设计文档、组件库、Tailwind CSS v4 和可复用的 RicoUI 主题。

© 2026 RicoUI . 基于 MIT 协议开源。

v1.0.0 Astro 启动模板 Twitter Github RSS