Astryx
lastmod 2026-11-17created 2026-11-171 edits
Astryx는 Meta가 오픈 소스로 공개한 React 디자인 시스템이다. Meta 안에서 8년 동안 자라 회사에서 가장 많이 쓰이는 디자인 시스템이 되었고, 13,000개가 넘는 앱이 이 위에서 돌아간다. 컴포넌트 문서·템플릿·테마를 CLI 와 MCP 서버로도 제공해, 사람과 코딩 에이전트가 같은 레퍼런스를 보고 화면을 만들게 하는 것을 설계 목표로 둔다.
About
- React 19 이상이 필요하고 내부 스타일은 StyleX 로 작성됨. 쓰는 쪽은 미리 빌드된 CSS 를 import 하고 타입이 있는 컴포넌트를 쓰므로 빌드 플러그인이나 PostCSS·Babel 설정이 없음. 현재 베타
- 접근성을 갖춘 컴포넌트 150개 이상(공식 홈페이지는 180개 이상으로 표기), 다크 모드, 테이블 페이지·상세 페이지·폼 위저드 같은 페이지 템플릿 포함
- 테마는 CSS custom property 덮어쓰기 묶음이라 컴포넌트를 감싸거나 포크하지 않고 브랜드에 맞춤. 기본 테마 7종: neutral, butter, chocolate, matcha, stone, gothic, y2k
- 스타일 수정은
className에 Tailwind CSS, CSS Modules, 일반 CSS 중 프로젝트가 쓰던 방식을 그대로 씀. 더 깊이 고칠 때는astryx swizzle로 컴포넌트 소스를 프로젝트로 꺼내 직접 관리 - CLI(
@astryxdesign/cli)는search,component,template,build,theme,upgrade등의 명령과--json출력을 제공.astryx build "<idea>"는 시작할 템플릿과 빠진 부분에 쓸 블록·컴포넌트를 골라 줌 -
npx @astryxdesign/cli init --features agents --agent claude는 프로젝트의CLAUDE.md에 Astryx 사용 안내 블록을 넣음. 기본 대상은AGENTS.md이고 Cursor·Codex 용 옵션도 있음 - 원격 MCP 서버
https://astryx.atmeta.com/mcp에는 도구 2개가 있음.search는 컴포넌트·문서 주제·템플릿을 짧은 결과로 찾고,get은 props 와 코드 예시가 든 전체 문서를 돌려줌- Claude Code:
claude mcp add --transport http astryxhttps://astryx.atmeta.com/mcp
- Claude Code:
claude plugin marketplace add meta/astryx 후 claude plugin install astryx@astryx. 에이전트에게 astryx 명령을 언제 어떻게 쓰는지 알려 주는 스킬 하나만 들어 있음