王悦
← 作品集

设计系统文档站

为团队打造的组件库文档站点,基于 Storybook 与 Astro 混合架构。

2025年7月15日

设计系统StorybookAstro组件库

项目背景

团队组件库缺乏统一文档,新成员上手成本高。本项目旨在建立「活文档」,让设计与开发共享同一套组件标准。

架构设计

  • Storybook:交互式组件演示与 Props 文档
  • Astro:静态指南页、设计 token 说明
  • Monorepo:组件源码与文档同仓管理

成果

  • 覆盖 40+ 基础与复合组件
  • 设计 token 自动从 Figma 同步
  • 文档站点 Lighthouse 性能分 98+

经验总结

文档站的价值在于「可被找到」。我们为每个组件配置了搜索关键词和使用场景,显著降低了内部支持成本。