设计文档是这份模板的设计契约。它写明了主题方向、源文件、颜色令牌、排版、布局规则、暗色模式、动效和组件模式。
自定义模板时,先读设计文档再改组件。它能帮你避免各个页面的视觉细节各自为政。
推荐工作流
- 使用项目元数据更新
src/config/site.js。 - 在
src/styles/global.css中调整基础品牌令牌,在src/styles/themes.css中调整非默认主题覆盖。 - 查看
/elements了解视觉效果。 - 如果更改了系统规则,更新
docs/DESIGN.md。 - 使用现有组件构建新页面。
保持更新
主题有变动时,在同一个 PR 里同步更新设计文档。它不只是项目文档,更是后续贡献者保持网站视觉一致性的依据。