文档CLAUDE.md 模板React 组件库

React 组件库

该模板用于构建可复用 UI 组件体系,强调文档化、可测试性与语义化 API 设计。

适用场景

  • 多项目共享组件
  • 设计系统落地
  • 需要 NPM 私有包发布

推荐 CLAUDE.md 片段

## Component Rules
- Props 必须显式定义类型与默认行为
- 禁止破坏性改动未标注 changelog
- 所有组件都要有 a11y 检查项
 
## Docs & Tests
- 每个组件至少有一个 Storybook 示例
- 每个组件至少有一个行为测试

开发建议

  1. 先抽象设计令牌,再实现组件。
  2. 通过 Storybook 管理可视化回归。
  3. 为公开组件 API 维护变更日志。

相关页面

核心阅读路径

模板页更适合作为模板中心的分支,而不是孤立着陆页

这类页面容易被 Google 视为相似度较高的细分卡片。把它们明确接回模板中心和配置主线,会更有利于主题聚合。

关于我