Skill 说明
Astryx 是什么
Astryx 是一个开源设计系统,基于 React 19+ 和 StyleX,目前处于 Beta。它在 Meta 内部长了八年,成了公司里用得最多、规模最大的设计系统,支撑 13,000+ 应用。
它一次交付了整套东西:150+ 无障碍组件、品牌级主题、暗黑模式、开箱即用的模板,还有一个 CLI。你只要引入预构建的 CSS,用带类型的 React 组件就行——不需要构建插件,也不需要额外接纳一套样式方案。
和常见组件库相比,Astryx 的差异点主打「不锁死」:组件内部是开放的、可以在任意层级组合,需要更深的定制时 swizzle 会把组件完整源码 eject 到你项目里自己拥有;样式虽然是 StyleX 写的,但对使用者不可见,你可以直接用 className 配 Tailwind、CSS Modules 或普通 CSS;主题就是一串 CSS 自定义属性覆盖,设计师不用 fork 组件源码就能把外观改成自己的样子。
它最特别的一点是「为人也为 Agent 设计」:API、文档和 CLI 是一起设计的,人和 AI 助手走同一套参考来搭界面,这也是它自称 agent ready 的原因。
| 包名 | 作用 |
|---|---|
@astryxdesign/core | 组件、主题系统与工具函数 |
@astryxdesign/cli | 组件文档、模板、脚手架、主题、codemod |
@astryxdesign/build | StyleX 源码构建插件 |
@astryxdesign/theme-* | 七套现成主题:neutral / butter / chocolate / matcha / stone / gothic / y2k |
Astryx 怎么安装
要求 React 19 及以上,react 和 react-dom 是核心包的 peer 依赖。把核心、主题、StyleX 和 CLI 一起装上:
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
用 pnpm 或 yarn 的话把 npm install 换成 pnpm add / yarn add,依赖列表不变。
也可以把 CLI 全局装一次,让 astryx 在任何目录可用、每个编码 Agent 都能认得 Astryx;项目内仍会优先跑项目自己的版本:
npm i -g @astryxdesign/cli
建议再在 package.json 里加一条脚本,避免 AI 助手或新同事直接调 CLI 时踩路径错误:
"scripts": {
"astryx": "node node_modules/@astryxdesign/cli/clients/cli/bin/astryx.mjs"
}
之后用 npm run astryx -- component --list 这样调用。
Astryx 怎么使用
- 最简单的接入方式就是几个 CSS import 加一个 ThemeProvider,不需要构建插件,也不用配 PostCSS 或 Babel。
@astryxdesign/core的 README 里给了 Next.js、Tailwind、Vite 和 CDN 四种完整示例。 - 从
@astryxdesign/theme-neutral这类现成主题起手,再通过覆盖 CSS 自定义属性做品牌化,不用改组件源码。 - 用 CLI 查文档和清单:
npm run astryx -- component --list,需要模板或脚手架也走同一个命令。 - 遇到需要改内部实现的情况,用
swizzle把组件源码 eject 进项目再改,而不是在外面包一层。 - 覆盖样式直接用
className,项目里已经在用 Tailwind 就继续用 Tailwind,不必迁到 StyleX。
Astryx 适合谁用
- 用 React 19 做中后台、文档站、管理面板,需要大量现成无障碍组件的团队。
- 在用 AI 编码助手写前端、希望组件约定统一、Agent 不容易写错的开发者。
- 需要深度定制品牌外观、又不想 fork 整个组件库输出的设计团队。
- 已经在用 Tailwind 或 CSS Modules、不想为组件库再引入一套样式方案的存量项目。
- 还在 React 16/17 上的老项目暂时用不了,它要求 React 19+;也不需要组件库、纯手写样式的项目同样用不上。
Astryx 项目地址
- GitHub 仓库:https://github.com/meta/astryx
- 官方文档:https://astryx.atmeta.com
- Storybook:https://astryx.atmeta.com/storybook/
- 在线沙箱:https://astryx.atmeta.com/sandbox/
- npm 包:https://www.npmjs.com/package/@astryxdesign/core
- 贡献指南:https://github.com/meta/astryx/wiki/Contributing