用途:当需要新建或补充共享组件(按钮、卡片、文本、输入框等原语)、搭建展示领域实体列表的屏幕、新增设计令牌组、为组件补充 Storybook 变体故事,或让新功能的组件从第一次提交起就遵循设计系统时使用。也可用于建立或更新设计系统索引,让后续代理先发现并复用已有组件。
主要能力:模板据称按规则“天生正确”而非事后改造,使用 Unistyles v3 变体(不用样式逃生舱)、ref-as-prop、设计令牌、内置无障碍,并保持 web/iOS 一致(交互原语带 _web 的 hover/focus/cursor),每个生成文件都标注其满足的 expo-design-system 规则 ID。
可用模板:variant-component(可按下原语,含 variant/size、按下与禁用状态、web hover/focus/cursor、无障碍、ref)、card-surface(复合表面,含前后与 children 插槽、tone/inset 变体、elevation 令牌)、text-primitive(有类型的文本组件,不用原始样式,限制字体缩放)、form-field(带标签的输入,受控/非受控、ref、错误变体、web 聚焦环、无障碍)、list-screen(由原语组合的实体列表,FlashList、memo 行、web 行 hover/cursor、安全区)、token-group(原始→语义→组件令牌组,合并进 Unistyles 主题)、component-story(并排渲染全部变体的 Storybook 故事)、component-index(设计系统单一公共入口与清单目录,供代理复用)。
用法:选择模板,按模板头注释与表格为占位符取值(如 {ComponentName}、{ScreenName}、{Entity}/{entity}/{entity_plural}、{route_path}、{token_group}、{file_path}),替换单花括号标识符令牌,字面量的 TSX 与 Unistyles 花括号保持不变;将文件写至 design_system_dir(屏幕写至 app_dir),用 component-story 模板生成对应故事,并把新组件追加到设计系统索引。屏幕所导入的数据层(use{Entity}List 与领域类型)由使用者自行填充;脚手架只负责视图。约定细节见 references/conventions.md。
配置:config.json 可选,首次使用时若项目不同可覆盖 design_system_dir(默认 packages/design-system/src)与 app_dir(默认 app)。相关技能为 expo-design-system(模板遵循的规则包)与 expo-react-native-coder(围绕脚手架的组件做功能开发)。具体安装方式与限制资料暂未提供。