# Astryx

> An open source, customizable React design system with components, themes, templates, and a CLI built for both people and AI agents.

Astryx is an open source design system from Meta, built on React 19+ and StyleX and currently in Beta. It provides accessible React components, themes, page templates, and a CLI so that developers and AI coding assistants can build interfaces from the same reference. The project README says it grew inside Meta over eight years and powers 13,000+ apps.

## What It Is

Astryx is a component library and design system distributed as npm packages. Developers install the core package, a theme, and the CLI, import the base CSS, and wrap the app in a theme provider. Components are typed React components imported individually, for example from the Button entry. According to the README, no build plugin or styling library is required to use it.

## Theming and Customization

A theme is a set of CSS custom property overrides, so a brand look can be applied without forking component source. Seven themes are documented: neutral, butter, chocolate, gothic, matcha, stone, and y2k. Styles can be overridden with className using Tailwind, CSS modules, or plain CSS, and there is deep integration with StyleX through the xstyle prop. A swizzle option ejects a component's full source into the project.

## Built for Agents

The CLI lists components, props, tokens, doc topics, and templates, and can scaffold projects and manage themes. The `init` command generates agent docs (AGENTS.md/CLAUDE.md) and is non-interactive, which makes it usable by AI agents, CI, and scripts. The site also describes agent access via an MCP interface.

## Setup Path

Install @astryxdesign/core, @stylexjs/stylex, a theme package, and @astryxdesign/cli, then run `npx @astryxdesign/cli init`. Example apps are provided for Next.js (plain, StyleX, Tailwind) and Vite with Tailwind. An upgrade command moves all Astryx packages to the same release.

## Features
- 150+ accessible React components (site cites 180+)
- Brand-level theming with dark mode
- Seven ready-made themes
- Ready-to-ship page templates
- CLI for components, tokens, templates, themes, docs, and codemods
- Agent docs generation (AGENTS.md/CLAUDE.md)
- MCP access for agents
- StyleX integration with className overrides (Tailwind, CSS modules, plain CSS)
- Swizzle to eject component source
- Storybook and sandbox playground
- TypeScript support

## Integrations
React, StyleX, Next.js, Vite, Tailwind CSS, Storybook, MCP

## Platforms
WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Version
v0.7.11

## Links
- Website: http://astryx.atmeta.com
- Documentation: https://astryx.atmeta.com/docs/getting-started
- Repository: https://github.com/meta/astryx
- EveryDev.ai: https://www.everydev.ai/tools/astryx
