Meta가 8년간 품고 있던 사내 디자인 시스템 Astryx, MIT로 공개

Meta가 이번 주 사내 디자인 시스템을 GitHub에 올렸다. 저장소는 meta/astryx, 라이선스는 MIT, npm 패키지는 @astryxdesign/core다. 하루 남짓에 스타 863개. 에이전트 스킬 저장소 기준으로는 소박하지만, 나온 물건은 주말 프로젝트가 아니다. Astryx는 Meta 안에서 8년 자랐다. 회사가 가진 것 중 가장 크고 가장 많이 쓰이는 디자인 시스템이며, 현재 1만3000개 이상의 애플리케이션 아래에 있다.
흥미로운 건 그 숫자다. 공개되는 디자인 시스템 대부분은 새 출발점으로 도착한다. 작은 컴포넌트 묶음, 그럴듯한 문서 사이트, 접근성에 대한 약속. Astryx는 10년치 논쟁이 이미 정리된 상태로 온다. 기획자와 디자이너와 엔지니어가 밤 11시에 부딪혔을 때, 파괴적 확인 대화상자가 어떻게 생겨야 하는지를 Meta의 누군가가 결정해야 했다. 그 결정이 상자 안에 들어 있다.
실제로 나온 것
React 19 이상이 전제이고, Meta 자체 스타일링 라이브러리인 StyleX로 작성됐다. 또 다른 스타일링 런타임은 싫다며 여기서 읽기를 멈추기 전에, 중요한 설계 결정 하나. StyleX는 쓰는 쪽에서 보이지 않는다.
@astryxdesign/core를 설치하고, 테마를 불러오고, 미리 만들어진 CSS를 가져와 타입이 붙은 React 컴포넌트를 쓴다. 설정할 빌드 플러그인이 없고, PostCSS나 Babel 단계도 없고, 번들러에 추가할 컴파일러도 없다. 모양을 바꾸고 싶으면 className을 넘겨 Tailwind든 CSS 모듈이든 순수 CSS든 쓰면 된다. Astryx는 상관하지 않는다. 기존 툴체인은 아무것도 바꿀 필요가 없다.
이건 대부분의 디자인 시스템이 따르는 패턴을 의도적으로 뒤집은 것이다. 흔한 수법은 컴포넌트가 자체 일관성을 보장하려고 사용자를 특정 스타일링 해법에 가두는 것. Astryx는 일관성을 컴포넌트 API에 두고, 스타일링은 프로젝트에 이미 있는 자리에 남긴다.
테마도 같다. 테마는 CSS 사용자 정의 속성 덮어쓰기 묶음이고, neutral, butter, chocolate, matcha, stone, gothic, y2k 일곱 가지가 기본 제공된다. 맞는 게 없으면 디자이너가 사용자 정의 속성을 다시 정의해, 컴포넌트를 하나도 포크하지 않고 기본값과 전혀 다른 시스템을 만들 수 있다.
조합은 모든 층에서 열려 있다. 컴포넌트를 이루는 부품이 그대로 내보내지므로, 테이블 행이나 메뉴 항목, 폼 필드를 새로 발명하지 않고 다시 조립할 수 있다. 그것으로 부족하면 swizzle이라는 CLI 명령이 컴포넌트 소스 전체를 프로젝트로 뽑아낸다. 그때부터는 내 것이니 원하는 대로 바꿀 수 있다. 대부분의 디자인 시스템이 아예 제공하지 않거나 형편없이 제공하는 탈출구다.

패키지에는 접근성을 갖춘 컴포넌트가 150개 이상 있고, 사내 도구에서 반드시 나오는 레이아웃 템플릿도 포함된다. 테이블 페이지, 상세 페이지, 폼 위저드, 내비게이션. 전체는 베타다.
에이전트 이야기는 마케팅이 아니다
Meta가 반복하는 문장은 “인간과 AI를 위한 하나의 시스템”. 이렇게 말하는 벤더는 많다. Astryx에는 구조적인 근거가 있다.
API와 문서와 CLI는 같은 참조 자료에서 함께 설계됐다. CLI가 스캐폴딩용으로 나중에 붙은 게 아니라는 뜻이다. CLI는 컴포넌트 문서를 들고 다닌다. astryx docs는 시스템이 어떻게 동작하는지 답한다. astryx component --list는 무엇이 있는지 나열한다. 셸 명령을 실행할 수 있는 코딩 에이전트라면, 신입이 문서 사이트를 읽는 방식으로 Astryx를 조회해 같은 답을 얻는다.
CLI가 생각보다 중요한 데는 실무적인 이유가 있다. 한 번도 본 적 없는 디자인 시스템으로 에이전트가 React 컴포넌트를 쓸 때 실패의 형태는 문법 오류가 아니다. 그럴듯한 prop 이름을 발명하는 것이다. 다른 라이브러리가 다 그렇게 쓰니까 라고 쓰고, 컴포넌트는 조용히 기본값을 그린다. 컴포넌트를 나열하고 실제 props를 출력할 수 있는 CLI는, 에이전트 학습 데이터에 그 라이브러리가 없어도 이 틈을 메운다.
Meta는 또 글로벌 바이너리에 의존하지 말고 package.json 스크립트로 CLI를 넣으라고 권한다.
"scripts": {
"astryx": "node node_modules/@astryxdesign/cli/clients/cli/bin/astryx.mjs"
}
그러면 CLI는 그 스크립트 이름으로 실행된다. 제시된 이유는 어시스턴트나 새 개발자가 바이너리를 직접 호출할 때 생기는 경로 오류다. 실제로는 에이전트 워크플로에서 린터를 돌릴 때 하는 조언과 같다. 진입점을 지루하고 안정적으로 만들어 아무도 추측하지 않게 하라.
설치 자체는 명령 세 개다.
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
npm i -g @astryxdesign/cli
앞의 두 개는 프로젝트 단위. 세 번째는 선택이며 CLI를 전역에 설치해 어느 폴더에서든 astryx가 동작하게 한다. 프로젝트가 생기기 전부터 에이전트에 디자인 시스템 지식을 쥐여주고 싶다면 이게 필요하다.
원칙은 싸움 끝에 쓰인 것처럼 읽힌다
저장소에는 원칙 네 개가 있고, 하나같이 긴 사내 논쟁의 결론처럼 들린다.
강제보다 안내. 컴포넌트는 능력을 주는 것이지 맞서는 가드레일이 아니다. 디자인 의견은 문서와 예제에 산다. 값을 넘기면 컴포넌트는 그대로 그린다. 잘못된 색의 버튼은 그리지 않겠다는 디자인 시스템과 정반대이고, Astryx는 못생긴 것도 기꺼이 만들게 둔다. Meta가 택한 거래다.
강하고 문서화된 관례. 모든 컴포넌트가 같은 명명, prop, 조합 규칙을 따른다. 몇 개를 익히면 나머지도 예측대로 움직인다. 이 예측 가능성은 사람에게는 이점이고 모델에게는 요건이라고 설명된다. Astryx 컴포넌트를 세 개 본 모델은 관례가 같으니 네 번째로 일반화할 수 있다.
인간과 AI를 위한 하나의 시스템. API, 관례, 문서, CLI가 함께 설계됐다. 여기 붙는 주장은 정직하다. Astryx를 AI에게 쉽게 만든 변경은 사람에게도 쉽게 만들었다. 한쪽만 도운 변경은 아마 나쁜 변경이었다.
측정으로 얻은 것. 관례를 주장하지 않고 시험하며, 반례가 나오면 결론을 다시 본다. 밖에서 가장 잘 보이지 않는 원칙이고, 시스템이 8년과 1만3000개 앱을 버틴 이유이기도 하다.
얇은 곳
여기서 베타는 법적 형식이 아니다. 패키지 목록에 이음매가 보인다.
@astryxdesign/lab은 실험적 컴포넌트를 담고 npm에는 배포되지 않는다. Storybook과 샌드박스용이다. @astryxdesign/vega와 @astryxdesign/charts는 존재하지만 @canary dist-tag로만 있고 안정판이 없다. 사내 대시보드마다 필요한 차트는 아직 출시 기능이 아니다.
React 19는 필수다. 옮길 수 없는 의존성 때문에 React 18에 머문 앱은 아직 대상이 아니다.
CSS 사용자 정의 속성으로 하는 테마는 우아하지만, 테마가 구조적 규칙을 강제할 수 없다는 뜻이기도 하다. 색, 간격, 반경, 서체는 바꾼다. 테이블이 정렬되는 방식은 바꾸지 못한다. 합리적인 선이지만 선이다.
그리고 Meta의 밀도와 워크플로에 맞춘 시스템이 12명짜리 스타트업에 맞느냐는 뻔한 질문이 남는다. Meta 사내 도구는 정보가 빽빽하고 키보드 중심이며, 그렇게 훈련된 사람이 쓴다. 사진 앱이나 결제 흐름은 문제의 모양이 다르다. 컴포넌트는 돌아갈 것이다. 기본값은 두 치수 큰 정장처럼 느껴질 수 있다.
이 공개가 주목받을 만한 이유
정직하게 말하면, 모두가 하는 주장을 시험할 좋은 사례라서다.
그 주장은 디자인 시스템을 이제 에이전트를 위해 만들어야 하고, 그 방법은 AI 기능을 붙이는 게 아니라 문서와 도구를 기계가 읽을 수 있게 만드는 것이라는 것이다. Astryx는 이만한 면적을 가진 회사가 그 아이디어를 MIT로, 소스를 뽑아낼 수 있는 형태로 오픈소스화한 첫 대형 시스템이다.
되면 패턴이 퍼진다. 문서는 CLI로, 관례는 계약으로, 컴포넌트는 조합 가능한 소스로. 안 되면 실패는 구체적이고 눈에 보이게 되고, 나머지 모두가 1년을 아낀다.
첫 며칠에 스타 1만6000개는 적어도 호기심이 있다는 뜻이다. 흥미로운 숫자는 석 달 뒤 그 저장소 중 몇 개가 여전히 @astryxdesign/core를 import하는지, 그리고 그중 얼마가 CLI를 읽은 에이전트가 주로 작성한 것인지다. “AI를 위해 만들어졌다”를 재는 훨씬 나은 지표다.
관련 글
중국산 안드로이드 시스템 UI의 광고를 끄는, 커뮤니티가 관리하는 탭 표
시스템을 건드리지 않고, 잠금 해제도, 플래싱도 하지 않는다. 제조사가 이미 열어 둔 스위치를 하나씩 뒤집을 뿐이다. 대가는 이 목록을 계속 써 줄 사람이 필요하다는 것이다.
GPT Image 2.6, 토큰 단가는 그대로 두고 청구서를 올렸다
GPT Image 2.6은 2.5의 토큰 단가를 하나도 바꾸지 않았는데 이미지 한 장 값은 올랐다. 작업의 상당 부분이 이제 출력 토큰에서 일어나기 때문이다. 출시 11일째, 가격 구조가 순위표보다 많은 것을 말한다.
IDM을 바깥에서 다시 만든 사람이 손대지 않은 부분을 적어 두었다
Mister Download Manager는 Internet Download Manager의 흐름을 Rust로 다시 구현해 5배 속도와 86개 언어를 내건다. 더 흥미로운 문서는 아무것도 복사하지 않고 어떻게 만들었는지 설명하는 문단이다.
Rune은 에이전트가 자기 작업을 검증할 수 있도록 만든 Rust UI 프레임워크
Rune은 헤드리스로 렌더링하고 요소 트리를 덤프하며 스크립트 입력을 받는다. 스크린샷으로는 얻을 수 없는, diff 가능한 신호를 코딩 에이전트에게 준다. 프레임워크는 프리릴리스이며 풀 리퀘스트를 받지 않는다.