Free guide
Astryx: Give Your AI Agent Meta's Design System So Every Screen Matches
Meta's open-source design system ships 150+ React components, seven themes and a CLI your coding agent reads from. What it is, how it works, how to set it up today, and the fine print.
The short version
- Astryx (github.com/meta/astryx) was the number one repo on GitHub's weekly trending list on Nov 15, 2026, with 13,660 stars that week and about 28,000 in total. Latest release: v0.7.16 (Nov 14). It's not new: Meta open-sourced it earlier this year.
- Meta says it grew inside the company over eight years and powers 13,000+ apps there. It ships 150+ accessible components, seven themes, dark mode, templates and a CLI.
- It's free (MIT) but still in beta, and it needs React 19 or later.
How it actually works
The problem: an agent with no catalog
Ask a coding agent for three screens and you often get three different looks: different buttons, spacing and colors on every page. It's like a contractor with no catalog who picks new tiles for every room. A longer prompt doesn't really fix that, because the agent still has nothing fixed to pick from.
Astryx is the catalog
Astryx is the design system Meta builds with. The README says it grew inside Meta over eight years and became the most-used and largest design system in the company, powering 13,000+ apps. It ships 150+ accessible React components, page templates (dashboards, settings, forms, detail pages), dark mode and a CLI, as one system.
astryx init hands the catalog to your agent
Once the CLI is in your project, npx @astryxdesign/cli init writes the Astryx component index into your AGENTS.md or CLAUDE.md. Your agent reads that file, so it discovers the real components, templates and design tokens instead of guessing. When it needs details, it can ask the CLI itself, for example npx @astryxdesign/cli component Button for one component's full docs. Meta designed the API, docs and CLI together so a person and an AI assistant build the same way.
One theme swap repaints every screen
A theme in Astryx is a set of CSS custom property overrides. Every component reads the same tokens, so when you swap the theme (neutral, butter, chocolate, matcha, stone, gothic or y2k), every screen built from Astryx components changes with it, without forking or wrapping component code.
How to set it up
1.Start from a React 19 app
Astryx needs React 19 or later. A new Next.js or Vite app works. Install Astryx, the neutral theme and StyleX (Astryx ships pre-built CSS, so there's no build plugin to set up).
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex2.Add the CLI and run init
Install the CLI in the project, then run init. It writes the Astryx component index into your AGENTS.md or CLAUDE.md so Claude Code, Codex or Cursor can find the components. Always use the scoped name @astryxdesign/cli: the plain astryx name on npm is an unrelated package until the CLI is installed in your project.
npm install -D @astryxdesign/cli npx @astryxdesign/cli init3.Import the CSS and wrap your app in the theme
In your global stylesheet, import the reset, the components and the theme, in this order. Then wrap your app in the Theme provider with neutralTheme from @astryxdesign/theme-neutral/built.
@import '@astryxdesign/core/reset.css'; @import '@astryxdesign/core/astryx.css'; @import '@astryxdesign/theme-neutral/theme.css';4.Ask your agent to build a page from a template
Browse the templates first, then tell your agent something like: build a settings page from the Astryx settings template, using only Astryx components. You can check any component it picks with the CLI.
npx @astryxdesign/cli template --list npx @astryxdesign/cli component Button5.Swap the theme
Install another theme, swap the theme.css import and the theme you pass to Theme, and every Astryx screen changes together. Matcha, for example, is an earthy green theme.
npm install @astryxdesign/theme-matcha # globals.css: @import '@astryxdesign/theme-matcha/theme.css'; # providers: import {matchaTheme} from '@astryxdesign/theme-matcha/built';
The fine print
- Beta: the README says Astryx is currently in beta, and new versions ship several times a week (v0.7.12 to v0.7.16 between Nov 10 and Nov 14). Pin a version for real projects.
- License: MIT, free. Only React 19 or later is supported.
- Use the scoped @astryxdesign/cli name. The unscoped astryx package on npm is not Meta's until the CLI is a dependency of your project.
- The README also offers a global install (npm i -g @astryxdesign/cli) so every coding agent on your computer knows Astryx. That writes agent text outside your project, so start with the project install and read astryx docs global before choosing it.
- Templates and themes are a starting point, not a brand. You still need to check your agent's pages: one of Astryx's own principles is guidance over enforcement, so the components render whatever values you pass.
FAQ
What is Astryx?
Astryx is Meta's open-source design system for React 19: 150+ accessible components, seven themes, dark mode, page templates and a CLI. Meta says it grew inside the company over eight years and powers 13,000+ apps there.
How does Astryx work with Claude Code?
Run npx @astryxdesign/cli init in your project. It writes the Astryx component index into CLAUDE.md or AGENTS.md, so Claude Code discovers the components, templates and design tokens instead of guessing, and it can look up any component with the CLI.
Is Astryx free?
Yes. It's open source under the MIT license. It's still in beta.
Does Astryx work with Tailwind?
Yes. Astryx styles its components with StyleX, but you don't have to adopt it. You can override with className using Tailwind, CSS modules or plain CSS, and the core package ships a Tailwind bridge stylesheet that maps its tokens to Tailwind utilities.
How many themes does Astryx have?
Seven ready-made themes: neutral, butter, chocolate, matcha, stone, gothic and y2k. Each theme is a set of CSS custom property overrides, so you can also make your own.
Sources
- Astryx on GitHub
- Astryx docs
- Astryx sandbox (try the themes)
- @astryxdesign/core quick start (Next.js, Tailwind, Vite)
- Astryx CLI reference
Facts checked 2026-11-15 against the Astryx README, the packages/core, packages/cli and theme-matcha READMEs, npm (@astryxdesign/core 0.7.16), the GitHub API (28,342 stars, MIT, release v0.7.16 on 2026-11-14) and GitHub's weekly trending page (number one, 13,660 stars this week, read 08:20 UTC). We didn't install it for this guide.
Want help building with tools like this?
Join the Shipping Skool community free. Paid members get live bootcamp calls every week and weekly-updated courses.
Join Shipping SkoolMore free guides
How ChatGPT Wallet Pays Without Seeing Your Card (and How to Set It Up)
OpenAI's new ChatGPT Wallet lets your dot pay for things on your behalf, and neither the agent nor the store ever sees your real card number. Here's how the stand-in card works and how to set it up.
Claude Code Custom Themes: Animated Backdrops and Your Own Colors
The Claude Code desktop app can now wear a theme: your own colors and an animated scene behind the chat. Here is how a theme works, two ways to get one today, and why you should treat a theme like code.
How Google's Antigravity Orchestrator Works (and How to Turn It On)
Google's new Orchestrator runs two Gemini models in one coding session: a big one that plans and a fast one that does the work. Here's how the hand-off works and how to switch it on.