用途:为 gluestack-ui v4 项目强制统一、约定式的样式写法,减少决策疲劳、提升性能、保证主题一致性,并把实现方式限制在规范模式内。
主要能力与规则:优先使用 Gluestack 组件而非 React Native 原语;组件已有属性(size、variant、space)时优先用属性而非 className;颜色只允许语义化 token(如 text-foreground、bg-primary、border-border),禁止 typography-、neutral-、gray-、slate- 及 red-500 这类编号色,可选 alpha(/70、/90);优先 className 而非内联样式;间距遵循比例刻度,不用任意值;组件采用复制进代码库而非作为依赖安装,并用复合子组件模式(如 ButtonText、InputSlot、FormControlLabel),InputIcon 必须包在 InputSlot 内;删除无用代码。
使用方式:作为主技能协调多个子技能——setup 负责初始化、用 CLI(npx gluestack-ui init -y、npx gluestack-ui add --all -y)添加组件与配置;creating-components 提供模板与配方;components 讲组件结构与组合;styling 讲颜色、间距、暗色模式与 tva 变体;variants 讲自定义变体;performance 讲跨平台与性能;validation 提供检查清单与反模式。使用任何组件前应先在官方文档核实最新用法(https://v4.gluestack.io/ui/docs/components/${componentName}/ 与 https://v4.gluestack.io/ui/docs)。
适用场景:创建带样式的新组件、审查或重构现有样式、修复样式不一致、添加暗色模式、主题化、从 gluestack-ui 复制组件。
限制:本资料未提供收费、价格与效果数据;具体平台支持范围与版本细节未详尽说明,需以官方文档为准。