What Is Astryx (2026)? Meta's React Design System for AI Agents
By Antigravity Skills editorial team · Last updated
Short answer: Astryx is an open-source React design system from Meta, currently in beta and released under the MIT license. It ships more than 150 accessible components, themes and page templates, plus a command-line tool that AI coding agents can use to look up components, scaffold pages and read docs. It requires React 19 or later and is built on StyleX. You install it from npm.
Skill page: the agent skills for Astryx have their own guide, Astryx skills: install and use.
Unofficial guide. Antigravity Skills is not affiliated with Meta or Astryx. Facts below come from the official GitHub repository README, the Astryx CLI README and the official site, checked on November 18, 2026. A beta project changes quickly, so confirm commands on the official pages before you rely on them.
What is Astryx?
The README describes Astryx as a fully customizable design system "built for how we build now: by people and the agents working alongside them." It grew inside Meta over about eight years and is described there as the company's most-used and largest design system, powering more than 13,000 apps. What you get:
- 150+ accessible React components, with dark mode and brand-level theming.
- Seven published themes: neutral, butter, chocolate, matcha, stone, gothic and y2k.
- Page and block templates, and a CLI.
- Styling with StyleX, but without lock-in: you can still override with
classNameusing Tailwind, CSS modules or plain CSS. - Theming by overriding CSS custom properties, with no wrapper tricks.
- A
swizzlecommand that copies a component's full source into your own project, if you want to own and edit it.
The README lists its guiding principles as guidance over enforcement, strong documented conventions, one system for humans and AI, and conventions earned through measurement.
Is Astryx free, and what is its status?
The README states the license is MIT and the status is Beta. One trade-press write-up of the launch did not name a license, so rely on the repository itself for that. A third-party guide on Better Stack says the public API is still evolving and suggests it suits new projects where you control the full stack; that is that author's advice, not an official statement. We did not find independent evidence of adoption outside Meta, so treat the "13,000 apps" figure as Meta's own claim about internal use.
What does the CLI do for AI agents?
This is the part that sets Astryx apart from a plain component library. The CLI README lists 17 commands. We grouped them by purpose in a table of our own:
| Job | Commands | What the CLI README says they do |
|---|---|---|
| Find things | search, component, hook, docs, blog | One ranked search across components, hooks, docs, templates and themes; list components or print docs; read reference docs and the blog |
| Build pages | template, build | List, show or scaffold page and block templates; build returns a template to start from, or the workflow playbook |
| Set up and maintain | init, doctor, upgrade, theme | Initialize the system in a project; diagnose projects; update code after an upgrade (and refresh ShadCN-copied components); add, switch and build themes |
| Customize | swizzle, experimental | Copy component source; try features that may change in a patch release |
| Extend and report | integration, discover, gap-report | Author and verify integration packages; browse integrations; report a missing component to the package that owns it |
| Agent access | mcp, plus --json on most commands | mcp serves every command as an MCP tool over stdio, for AI tools that cannot run shell commands |
Three details matter for agents:
initcan write agent docs into your project. The--agentoption selects the agent,--remove-agentsremoves the managed block, and--userwrites machine-level agent text including a skill file. A Better Stack caption mentions initializing for Claude, Cursor and Copilot; we could not confirm the full list of supported agents on the official pages we could load, so check the CLI docs.astryx manifest --jsonreturns every command, option and response type as JSON, so an agent can learn the CLI without parsing--helpoutput.- A
--denseflag reportedly strips human-oriented filler from docs output, for examplenpx astryx docs styling --dense(Better Stack). We did not see this flag in the CLI README excerpt we read.
The official site pitches the same idea in one line: scaffold projects, browse templates, generate themes and get agent-ready docs from the command line or MCP.
How to install Astryx
The README gives these commands. React 19 or later is required, and react and react-dom are peer dependencies of @astryxdesign/core.
# npm
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
# pnpm
pnpm add @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
pnpm add -D @astryxdesign/cliYarn commands are also in the README. Setup then needs a few CSS imports and a theme provider; the README says no build plugin, PostCSS or Babel configuration is required, and its core README covers Next.js, Tailwind, Vite and CDN setups.
To run the project-local CLI reliably, the README suggests a script in package.json and then npm run astryx -- component --list:
"scripts": {
"astryx": "node node_modules/@astryxdesign/cli/clients/cli/bin/astryx.mjs"
}You can also install the CLI globally with npm i -g @astryxdesign/cli. The README recommends the project-local copy, because an AI assistant then runs the same version as the project and avoids path errors.
How does Astryx relate to AI coding agents?
Astryx does not replace your agent. It gives an agent, such as Claude Code or Codex, a structured source of truth for UI work: documented components, templates and theme tokens that it can query instead of guessing. The usual flow is to install the packages, run init for your agent, then ask the agent to build a page from the CLI's templates. If you want to see how agents pick up reusable instructions, read how to install skills in Antigravity, Claude Code and Codex. The init --user skill file is the same general idea.
Common questions
Is Astryx the same as shadcn/ui?
No. The CLI README mentions refreshing ShadCN-copied components during upgrade, so the two can coexist, but Astryx is its own system with its own components, themes and CLI. We did not find an official comparison page.
Does it need Tailwind?
No. It uses StyleX internally and lets you override styles with Tailwind, CSS modules or plain CSS.
Which packages are not stable?
Per the README, @astryxdesign/lab is internal and unpublished, while @astryxdesign/vega and @astryxdesign/charts are only on the @canary dist-tag.
Is it production ready?
The project calls itself beta. Weigh that against how stable your own requirements are.
Where is the official repository?
The README links to github.com/facebook/astryx and some of its wiki links use the meta/astryx path. We could not confirm whether one redirects to the other, so start from the official docs site.
Related on Antigravity Skills
- OpenClaw: an open-source self-hosted AI agent, another agent-oriented open-source project
- REA: an MCP server and CLI for AI agents, a similar MCP plus CLI approach
- gstack: a skill setup for Claude Code
- How to install skills in Antigravity, Claude Code and Codex
- All skills