Astryx brings Meta's internal React design system to open source with agent tooling
Astryx, a beta MIT-licensed design system from Meta, ships 150+ React components, CSS-variable themes and a CLI meant to be used the same way by developers and AI assistants.
What Astryx is
Astryx is an open source design system published by Meta under the MIT license and written in TypeScript. Its README says it grew inside Meta over the last eight years, where it became the most-used and largest design system in the company, powering 13,000+ apps. It is currently in beta and is built on React 19+ and StyleX.
The repository was created on 2026-01-09. In the GitHub trending snapshot it had 16279 stars, 863 of them gained in the last day, and 1297 forks.
The system ships 150+ accessible components, brand-level theming, dark mode, ready-to-ship templates and a CLI. Consumers import pre-built CSS and use typed React components, with no build plugin and no styling library to adopt.
Design choices
The README highlights four differences:
- Open internals. Building blocks are exported directly rather than hidden behind a closed top-level API, and a swizzle feature ejects a component’s full source into a project so the team can own it.
- No styling lock-in. Styles are authored with StyleX, but that is invisible to consumers, who can override with
classNameusing Tailwind, CSS modules or plain CSS. - Customize without wrapping. A theme is a set of CSS custom property overrides, so a designer can restyle Astryx without forking or wrapping component source.
- Built for people and agents. The API, docs and CLI are designed together so a person and an AI assistant build the same way, from the same reference.
The stated principles follow the same line. Components favor guidance over enforcement: design opinions live in docs and examples, and if you pass a value, the component renders it. Every component follows the same naming, prop and composition rules, so that both people and AI can predict how an unfamiliar component behaves. The maintainers also say they test conventions rather than assert them and revisit them when a new situation proves them wrong.
Packages and setup
The published packages are @astryxdesign/core (components, theme system and utilities), @astryxdesign/cli (component docs, templates, scaffolding, themes and codemods), @astryxdesign/build (build plugins for StyleX source builds) and @astryxdesign/theme-*, which covers seven ready-made themes: neutral, butter, chocolate, matcha, stone, gothic and y2k. Astryx requires React 19 or later. A basic install looks like this:
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
The CLI can also be installed globally so that astryx works in any folder and every coding agent knows Astryx, while a project still runs its own pinned version. For reliable access, the README suggests adding a package.json script that calls the CLI from node_modules, which it says avoids path errors when AI assistants or new developers invoke it directly.
What is not stable yet
Besides the beta label on the whole system, some packages are not ready. @astryxdesign/lab, which holds experimental components, is used internally for Storybook and the sandbox and is not published to npm. The chart packages @astryxdesign/vega and @astryxdesign/charts are published only under the @canary dist-tag, and the README says there is no stable release yet. Contributors need Node 22+ on an active LTS line and pnpm 11.
Source: meta/astryx on GitHub