Astryx(Meta设计系统)

作者 设施特

让 AI 用现成组件库写界面,最常见的结果是类名乱套、样式互相打架。这是 Meta 开源的设计系统,内部用了 8 年、支撑 13,000+ 应用,150+ 无障碍组件加 CLI 一起给人和 Agent 用,换主题不改组件源码。

Github
Skill 编程开发 v1.0.0 热度 430

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-41(Astryx(Meta设计系统))。
详情页:https://www.cweto.cn/work-41.html
GitHub:https://github.com/meta/astryx
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

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/buildStyleX 源码构建插件
@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 怎么使用

  1. 最简单的接入方式就是几个 CSS import 加一个 ThemeProvider,不需要构建插件,也不用配 PostCSS 或 Babel。@astryxdesign/core 的 README 里给了 Next.js、Tailwind、Vite 和 CDN 四种完整示例。
  2. 从 @astryxdesign/theme-neutral 这类现成主题起手,再通过覆盖 CSS 自定义属性做品牌化,不用改组件源码。
  3. 用 CLI 查文档和清单:npm run astryx -- component --list,需要模板或脚手架也走同一个命令。
  4. 遇到需要改内部实现的情况,用 swizzle 把组件源码 eject 进项目再改,而不是在外面包一层。
  5. 覆盖样式直接用 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