에이전트가 먼저 읽는 디자인 시스템, Meta의 Astryx를 설치해서 둘러봤습니다
Meta가 8년 동안 사내에서 쓰던 디자인 시스템 Astryx를 오픈소스로 공개했습니다. 다음 앱을 이걸로 만들기 전에 직접 설치해서 컴포넌트와 템플릿 화면, 테마를 띄워 봤습니다. 화면 예시와 함께 무엇이 좋은지, 들이기 전에 무엇을 확인해야 하는지 정리했습니다.
2026년 6월 18일, Meta가 Astryx라는 디자인 시스템을 오픈소스로 공개했습니다. 11월 14일에는 Vercel의 v0에서도 Astryx를 골라서 화면을 만들 수 있게 됐습니다. 소개 글의 제목은 "지금 우리가 만드는 방식에 맞춘 디자인 시스템"이었고, 여기서 말하는 "우리"에는 사람과 함께 코드를 쓰는 에이전트도 들어 있었습니다.
다음에 만들 앱을 Astryx로 시작하려고 합니다. 앱을 만들기 전에 시험용 프로젝트에 직접 설치해서 컴포넌트와 템플릿 화면을 띄워 보고, 테마도 바꿔 봤습니다. 이 글에서는 그 화면들과 함께 Astryx가 어떤 디자인 시스템인지, 무엇이 좋아 보였는지, 들이기 전에 확인할 것이 무엇인지를 다룹니다.
글에 실은 화면은 모두 Astryx 0.7.16의 템플릿을 고치지 않고 그대로 띄워 캡처한 것입니다. 화면 속 상품명과 숫자는 템플릿에 들어 있는 예시 데이터입니다. 버전과 숫자는 2026년 11월 16일 기준입니다.
1. Meta 안에서 8년을 쓴 디자인 시스템입니다
공식 소개 글에 따르면 Astryx는 Meta 안에서 8년 동안 다듬어졌고, 지금 1만 3천 개가 넘는 앱에서 쓰이고 있습니다. React와 StyleX 위에 만들었고, 접근성을 갖춘 컴포넌트 150개 이상과 브랜드 단위 테마, 다크 모드, 바로 쓸 수 있는 템플릿, CLI를 하나의 시스템으로 묶었습니다. StyleX는 Meta가 만든 CSS-in-JS 라이브러리로, 빌드할 때 스타일을 정적인 CSS로 뽑아냅니다. Astryx는 이미 빌드된 CSS를 같이 배포하기 때문에 앱 쪽에서 StyleX 컴파일러를 꼭 설정하지 않아도 됩니다.
| 항목 | 확인한 내용 |
|---|---|
| 만든 곳 | Meta |
| 공식 사이트 | astryx.atmeta.com |
| 저장소 | github.com/meta/astryx |
| 확인한 버전 | @astryxdesign/core, @astryxdesign/cli 0.7.16 |
| 라이선스 | MIT (npm 레지스트리 기준) |
| 상태 | 베타(Beta) |
| 필요 조건 | React 19 이상, @stylexjs/stylex |
컴포넌트 수는 출처마다 조금 달랐습니다. 공식 소개 글에는 150개 이상이라고 적혀 있는데, CLI에서 컴포넌트 목록을 뽑아 보면 이름이 78개 나옵니다. 하위 컴포넌트를 따로 셌는지에 따른 차이로 보이지만, 정확히 어떻게 센 숫자인지는 아직 확인하지 못했습니다.
2. 컴포넌트는 상태까지 한 벌로 나옵니다
Astryx CLI에는 테마를 확인하는 미리보기 앱을 만들어 주는 명령이 있습니다. 이 앱의 Components 페이지에 들어가면 모든 컴포넌트가 묶음별로 나오고, 각 컴포넌트의 변형(variant)과 상태가 나란히 그려집니다.

좋았던 점은 버튼 하나도 primary, secondary, ghost, destructive 변형이 처음부터 정해져 있고, 입력창은 오류(error)와 경고(warning) 상태가 아이콘과 테두리 색까지 갖춰져 있다는 것입니다. 화면을 만들 때 "오류일 때 테두리를 무슨 색으로 하지"를 정할 필요가 없습니다. 에이전트에게 화면을 맡길 때도 이 부분이 중요합니다. 정해진 상태가 없으면 에이전트는 화면마다 조금씩 다른 빨간색을 고릅니다.
3. 템플릿으로 띄운 화면들입니다
Astryx 템플릿은 페이지 단위가 58개, 페이지 안에 넣는 블록 단위가 726개입니다. 페이지 템플릿은 대시보드, AI 채팅, 결제, 로그인, 칸반 보드, 설정, 표처럼 앱에서 자주 만드는 화면을 거의 다 덮고 있습니다. astryx template <이름> <경로> 한 줄이면 프로젝트에 파일로 복사됩니다.
먼저 분석 대시보드(Analytics Dashboard) 템플릿입니다. 위에 큰 차트, 아래에 지표 카드, 그 아래에 분포 막대가 이어지는 3단 구성입니다. 차트는 Recharts로 그립니다.

다음은 AI 채팅(AI Chat Conversation) 템플릿입니다. 이 템플릿을 보고 Astryx가 어떤 앱을 염두에 두고 만들어졌는지 감이 왔습니다. 에이전트가 파일을 읽고 명령을 실행한 기록(tool calls)이 접히는 목록으로 나오고, 답변 안의 코드 블록과 오른쪽 문서 패널까지 들어 있습니다. AI 기능이 들어가는 앱이라면 이 화면을 처음부터 짜지 않아도 됩니다.

장애 대응 콘솔(Incident Console)은 데이터가 많은 화면의 예시입니다. 행이 상태별로 묶여 있고, 하나를 고르면 오른쪽에 상세 정보와 타임라인이 열립니다. 목록을 카드로 감싸지 않고 행으로 보여 주는 점이 눈에 띄었는데, 뒤에서 이야기할 Astryx의 규칙이 그대로 반영된 화면입니다.

마지막은 결제 양식(Checkout Form)입니다. 왼쪽에는 긴 입력 양식이, 오른쪽에는 주문 요약이 있습니다. 입력창, 체크박스, 선택 상자, 도움말 아이콘이 모두 같은 높이와 간격으로 맞춰져 있습니다.

템플릿을 띄워 보면서 가장 좋았던 건 화면마다 간격과 글자 크기가 같은 규칙을 따른다는 점입니다. 서로 다른 사람이 만든 템플릿처럼 보이지 않습니다. 시작 문서도 빈 화면이 아니라 템플릿에서 시작하고, 틀과 간격은 그대로 둔 채 내용만 바꾸라고 안내합니다.
4. 테마 하나로 같은 화면의 인상이 바뀝니다
소개 글은 지금까지 디자인 시스템을 고를 때 둘 중 하나를 골라야 했다고 말합니다. 큰 회사의 디자인 시스템을 쓰면 그 회사의 브랜드까지 따라와서 내 앱이 남의 제품처럼 보입니다. 반대로 컴포넌트를 복사해 붙여 쓰는 방식은 자유롭지만, 프로젝트마다 코드가 갈라지고 위쪽에서 고친 버그를 받아 올 방법이 없습니다.
Astryx는 이 둘을 나눴습니다. 동작과 접근성은 시스템이 책임지고, 생김새는 테마가 맡습니다. 이게 실제로 어느 정도인지 보려고 테마 쇼케이스(Theme Showcase) 템플릿 하나를 코드는 그대로 두고 테마만 바꿔서 띄워 봤습니다.

왼쪽 위가 기본 테마인 neutral, 오른쪽 위가 파란 강조색의 butter, 왼쪽 아래가 필기체 제목과 둥근 카드의 matcha, 오른쪽 아래가 어두운 바탕의 gothic입니다. 바뀐 건 <Theme>에 넘긴 테마 객체 하나뿐입니다. 색만 바뀌는 게 아니라 글꼴, 모서리 둥글기, 버튼 모양까지 함께 바뀝니다. matcha에서는 카드 모서리가 크게 둥글어지고, butter에서는 장바구니 버튼이 테두리 버튼으로 바뀌었습니다.
다크 모드는 따로 만들 필요가 없습니다. 브라우저 설정을 어둡게 바꾸면 같은 neutral 테마가 아래처럼 바뀝니다.

CLI에 들어 있는 테마는 neutral, stone, butter, chocolate, matcha, gothic, y2k 일곱 개입니다. 새 테마는 실험 기능인 테마 편집기로 만들 수 있습니다. 색, 모서리, 간격, 글꼴을 하나씩 바꾸면 그 값이 실제 컴포넌트에 적용되는지 확인한 뒤에 반영하고, 바꿀 때마다 컴포넌트를 PNG로 그려서 보여 줍니다. 적용되지 않을 값은 아예 거절합니다.
5. 사람보다 에이전트가 먼저 읽도록 만들었습니다
소개 글에서 가장 눈에 띈 문장은 Astryx를 처음부터 AI가 다룰 수 있게(AI-operable) 만들었다는 부분입니다. 기존 디자인 시스템을 에이전트에 맞게 고친 게 아니라는 뜻입니다. 설치해 보니 이 말이 구체적인 장치로 나와 있었습니다.
첫째는 astryx init입니다. 프로젝트에서 이 명령을 실행하면 에이전트용 안내 파일(AGENTS.md, CLAUDE.md)을 써 줍니다. 아무것도 묻지 않고 끝나는 명령이라서 에이전트나 CI에서 돌려도 멈추지 않습니다. 시작 가이드에는 AI 코딩 도구에 그대로 붙여 넣을 설치 문장까지 들어 있습니다.
둘째는 CLI 자체입니다. astryx search로 컴포넌트, 훅, 문서, 템플릿, 테마를 한 번에 찾고, astryx component <이름>으로 props와 사용법을 읽습니다. 모든 명령에 --json 출력이 있고, 토큰을 아끼는 --dense 출력도 있습니다. 프로젝트 안에서 실행하면 그 프로젝트에 설치된 버전의 문서가 답하기 때문에, 에이전트가 최신 문서를 보고 옛 버전에 없는 props를 쓰는 일을 막아 줍니다.
셋째는 MCP 서버입니다. https://astryx.atmeta.com/mcp에 원격 MCP 서버가 열려 있고, 컴포넌트와 문서를 찾는 search, 전체 문서를 가져오는 get 두 가지 도구를 줍니다. Claude Code에서는 명령 한 줄로 붙일 수 있다고 안내합니다.
claude mcp add --transport http astryx https://astryx.atmeta.com/mcp넷째는 화면을 만드는 순서입니다. astryx build "<만들 화면 설명>"을 실행하면 어떤 템플릿에서 시작해야 하는지와 그 템플릿에 빠진 부분을 알려 줍니다. 빈 화면에서 에이전트가 레이아웃을 새로 발명하지 못하게 막는 장치입니다. 이 글의 화면을 띄울 때도 템플릿 이름 하나로 파일이 복사됐고, 필요한 패키지가 빠져 있으면 설치 명령까지 알려 줬습니다.
6. 규칙이 문서에 문장으로 적혀 있습니다
Astryx 문서의 설계 원칙(principles)에는 앱 코드가 지켜야 할 규칙 여덟 개와 하지 말아야 할 것들이 짧게 적혀 있습니다. 색과 간격을 직접 숫자로 쓰지 말고 의미 토큰(semantic token)을 쓸 것, 데이터가 많은 목록은 카드가 아니라 표나 행으로 보여 줄 것, 장식용 배지를 달지 말 것, 링크는 <a>를 직접 쓰지 말고 useLinkComponent()를 쓸 것 같은 내용입니다. 없는 props를 지어내기 전에 문서를 먼저 읽으라는 규칙도 있습니다.
읽으면서 눈에 띈 건, 이 목록이 에이전트가 만든 화면에서 자주 보이는 모습에 가깝다는 점입니다. 목록 항목마다 카드를 씌우고, 색을 # 값으로 박아 넣고, 상태를 보여 주려고 배지를 붙이는 식입니다. 앞의 장애 대응 콘솔 화면이 카드 대신 행을 쓴 것도 이 규칙 때문입니다. 문서에는 다 만든 화면이 시스템을 잘 썼는지 근거를 들어 점검하는 가이드(is-my-code-good)도 따로 있습니다.
11월 12일 샌프란시스코에서 열린 Astryx 밋업 후기에는 "에이전트가 그럴듯한 화면을 알아서 만드는데 디자인 시스템이 아직 필요한가"라는 질문이 나옵니다. 팀의 답은 생성이 빨라질수록 오히려 공유된 시스템이 더 중요해진다는 것이었습니다. 생성된 화면 여러 개에서 같은 문제가 반복되면, 공유된 원본 하나를 고쳐서 이후의 결과를 전부 낫게 만들 수 있다는 이유입니다.
7. 들이기 전에 확인할 것이 있습니다
좋아 보이는 것만큼 걸리는 것도 있었습니다. 먼저 아직 베타이고 버전이 0.7입니다. 업그레이드할 때는 astryx upgrade --from <이전 버전> --apply로 코드를 고쳐 주는 명령이 따로 있고, 테마 패키지마다 맞는 Core 버전이 정해져 있어서 모든 @astryxdesign 패키지를 같은 버전으로 함께 올려야 합니다.
React 19 이상이 필요합니다. 스타일은 기본 CSS만으로 쓸 수 있고, Tailwind CSS 4와 함께 쓰는 방법, 내 코드에 StyleX를 쓰는 방법이 문서에 각각 정리돼 있습니다. 다만 일부 템플릿은 레이아웃에 StyleX를 써서 컴파일러 설정이 필요했습니다. 이번에 띄운 템플릿 중에는 칸반 보드가 그랬습니다. Tailwind나 shadcn, Radix로 만든 앱을 조금씩 옮기는 이전 가이드도 있습니다.
문서 언어도 확인했습니다. CLI 문서는 영어가 기본이고 중국어 간체로 읽는 옵션이 있지만 한국어 번역은 없었습니다. 템플릿 예시 문구도 모두 영어입니다. 화면에 나오는 기본 문구의 한국어 처리는 국제화(internationalization) 문서를 따라 직접 확인해 봐야 합니다.
공개된 실제 서비스 사례를 찾기 어려운 점도 아쉬웠습니다. Meta 안의 앱 1만 3천 개는 밖에서 볼 수 없고, 공식 사이트의 예시 화면도 이 글에 실은 템플릿과 같은 데모 화면입니다. 공개된 시작점으로는 v0에 올라온 Astryx 스타터 템플릿 정도가 있습니다.
8. 다음 앱은 이 순서로 시작해 볼 생각입니다
아직 해 보지 않은 일이라 계획으로 적어 둡니다. 새 프로젝트에 @astryxdesign/core, @stylexjs/stylex, @astryxdesign/theme-neutral, @astryxdesign/cli를 설치하고 astryx init으로 에이전트 안내 파일을 만듭니다. Claude Code에는 MCP 서버를 붙여 둡니다. 화면은 astryx build로 시작할 템플릿을 고르고, 그 틀 위에서 내용만 바꿔 갈 생각입니다. 테마는 neutral로 시작한 뒤 앱의 성격이 잡히면 테마 편집기로 바꿔 볼 계획입니다.
이번에 확인하고 싶은 것은 세 가지입니다. 같은 요청을 했을 때 에이전트가 만든 화면들이 간격과 색에서 정말 일관되게 나오는지, 문서에 적힌 규칙을 에이전트가 어디서 어기는지, 그리고 그걸 고치는 데 드는 시간이 줄어드는지입니다. 결과는 앱을 만든 뒤에 다시 정리하겠습니다.
마치며
설치해서 템플릿 몇 개를 띄우기까지 생각보다 오래 걸리지 않았습니다. 템플릿 이름 하나로 화면이 복사되고, 테마 객체 하나로 같은 화면이 네 가지 인상으로 바뀌는 걸 보니 소개 글의 "동작은 시스템이, 생김새는 테마가"라는 말이 무슨 뜻인지 알 것 같았습니다.
다만 이번에는 템플릿을 그대로 띄워 본 것이고, 내 앱의 화면을 만든 건 아닙니다. 사람과 에이전트가 같은 시스템 위에서 일하는 게 정말 편한지는 다음 앱을 만들면서 직접 확인해 볼 생각입니다.
Comments (0)