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.

By Beau Johnson·

Quick answer

Astryx is Meta's open-source (MIT) design system for React 19: 150+ accessible components, seven themes, dark mode, page templates and a CLI. Install it in a React app, then run npx @astryxdesign/cli init, which writes the Astryx component index into your AGENTS.md or CLAUDE.md so your coding agent picks real components instead of guessing.

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. 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/stylex
  2. 2.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 init
  3. 3.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. 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 Button
  5. 5.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

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 Skool

More free guides