디자인 시스템 Astryx, 메타가 8년 쓴 걸 오픈소스로 풀었다

Astryx 공식 배너 위에 메타 디자인 시스템 Astryx 공개 제목

오늘 아침 깃허브 트렌딩을 보다가 메타(Meta) 저장소 하나가 눈에 걸렸어요. 이름은 Astryx. 하루 사이에 별이 2,800개 넘게 붙었더라고요. 열어 보니 메타가 회사 안에서 8년 동안 써 온 디자인 시스템을 통째로 공개한 프로젝트였습니다.

디자인 시스템은 버튼·입력칸·메뉴·표 같은 화면 부품과, 그걸 쓰는 규칙을 한데 묶은 세트예요. 웹사이트나 사내 프로그램을 만드는 분이라면 “또 버튼부터 만들어야 하나” 싶은 순간이 있잖아요. Astryx는 그 부품을 150개 넘게 미리 만들어 두고, 사람뿐 아니라 AI 코딩 도구도 같은 방식으로 쓰게 설계했다는 점을 앞세워요. 공식 문서와 깃허브를 읽고 무엇이 들어 있는지 정리했습니다.

Astryx 공식 사이트 첫 화면, An open source design system that's fully customizable and agent ready
마음대로 바꾸고 AI 에이전트도 쓰는 디자인 시스템 · 출처: Astryx 공식 사이트

메타 디자인 시스템 Astryx, 정체부터

공식 발표 글은 2026년 6월 18일에 올라왔어요. 제목이 “Introducing Astryx by Meta”이고, 상태는 베타(Beta)입니다. 발표문에 따르면 Astryx는 메타 안에서 8년 동안 다듬어졌고, 지금까지 1만 3천 개가 넘는 앱에 쓰였다고 해요. README에는 “메타에서 가장 많이 쓰이고 가장 큰 디자인 시스템”이었다는 설명도 붙어 있고요.

Introducing Astryx by Meta 공식 출시 발표 글 화면, 2026년 6월 18일
6월 18일 베타 공개 · 출처: Astryx 공식 블로그

기술 바탕은 React 19 이상과 StyleX예요. StyleX는 메타가 만든 CSS 도구인데, 쓰는 사람은 몰라도 됩니다. 미리 만들어진 CSS를 불러오고 타입이 붙은 React 컴포넌트(화면 부품)를 쓰는 구조라서, 빌드 플러그인이나 별도 스타일 라이브러리를 새로 들일 필요가 없다는 게 공식 설명이에요. 라이선스는 MIT라 회사 프로젝트에도 부담 없이 쓸 수 있습니다.

meta/astryx 깃허브 저장소 화면, 별 24.8k 포크 1.9k
별 약 2.48만 · MIT 라이선스 · 출처: Astryx 깃허브

11월 12일 아침 기준 깃허브 별은 약 2만 4,756개, 포크는 1,933개예요. npm 기준 최신 버전은 11월 11일에 나온 0.7.14이고, 핵심 패키지(@astryxdesign/core)는 11월 4~10일 한 주에만 약 63만 5천 번 내려받아졌어요. 아직 1.0 전인데도 꽤 많이 쓰이고 있다는 얘기죠.

안에 뭐가 들었나요?

README가 꼽는 구성은 접근성(키보드·화면 낭독기 지원)을 갖춘 컴포넌트 150개 이상, 브랜드 단위 테마, 다크 모드, 바로 쓰는 화면 템플릿, 그리고 CLI(명령줄 도구)예요. 공식 사이트 첫 화면에는 “Over 180 components”라고 적혀 있어서, 공개 뒤에도 계속 늘고 있는 것으로 보여요.

Astryx 컴포넌트 목록 페이지, 버튼·버튼 그룹·드롭다운 메뉴 예시
예제 코드를 복사해서 쓰는 컴포넌트 목록 · 출처: Astryx 공식 문서

컴포넌트 페이지에서는 버튼, 드롭다운 메뉴, 달력, 채팅 화면용 부품까지 하나씩 눌러 보고 예제 코드를 복사할 수 있어요. 템플릿 쪽은 한 단계 더 큽니다. 대시보드, 결제 화면, 로그인, 설정 화면, AI 채팅 화면처럼 페이지 하나가 통째로 들어 있어요.

Astryx 템플릿 페이지, 대시보드·결제·갤러리 화면 템플릿 모음
페이지 단위 템플릿 · 출처: Astryx 공식 문서
Astryx AI 채팅 화면 템플릿, 대화와 문서 패널
AI 채팅 화면 템플릿 · 출처: Astryx 공식 문서

테마 7종, 색만 바꾸는 게 아니에요

큰 회사 디자인 시스템을 가져다 쓰면 내 서비스가 그 회사 제품처럼 보이는 문제가 있죠. 출시 발표 글도 이 점을 짚어요. 그래서 Astryx는 동작·접근성은 시스템이 맡고, 겉모습은 테마가 맡도록 나눴습니다. 색, 글꼴, 모서리 둥글기, 움직임을 토큰(디자인 값) 단위로 바꾸는 방식이에요.

Astryx 테마 페이지, Neutral·Stone·Gothic·Matcha·Y2K 테마 목록과 쇼핑몰 예시 화면
기본 테마 7종 · 출처: Astryx 공식 문서

기본 제공 테마는 neutral, butter, chocolate, matcha, stone, gothic, y2k 이렇게 7개예요. 테마는 CSS 변수(custom property) 덮어쓰기 묶음이라, 컴포넌트 소스를 고치지 않고도 우리 가게 색으로 바꿀 수 있다고 해요. 부품 깊숙이 손대야 할 땐 swizzle 기능으로 컴포넌트 전체 소스를 내 프로젝트로 꺼내 올 수도 있고요. 스타일은 Tailwind, CSS 모듈, 일반 CSS 중 원래 쓰던 걸로 className만 넘기면 덮어써집니다.

AI 에이전트가 같이 쓴다는 건 무슨 뜻일까

Astryx가 가장 힘주어 말하는 부분이에요. 요즘은 클로드 코드나 커서 같은 AI 코딩 도구에게 화면을 만들라고 시키는 일이 많죠. 그런데 AI는 그 디자인 시스템을 잘 모르면 흔한 React 코드로 돌아가거나, 없는 속성을 지어내곤 해요. 공식 문서 “Working with AI”도 이 문제를 그대로 적어 두었습니다.

Astryx Working with AI 문서, init --features agents 명령 설명
AGENTS.md 자동 생성 · 출처: Astryx 공식 문서

해결 방법은 두 가지예요. 첫째, CLI의 init --features agents 명령이 컴포넌트 목록·규칙·CLI 설명을 담은 안내문을 AGENTS.md에 써 줍니다. 프로젝트에 CLAUDE.md가 있으면 클로드 코드가 AGENTS.md를 건너뛰기 때문에 그 파일에도 같이 써 준다고 하고, 제미나이 CLI용 GEMINI.md도 챙겨요. 둘째, MCP(AI 도구에 외부 기능을 붙이는 표준) 서버를 제공해요. 도구는 컴포넌트를 찾는 search, 문서와 예제를 가져오는 get 두 개입니다. AI가 필요할 때 직접 문서를 찾아보는 구조죠.

제 생각엔 이 부분이 별이 빨리 붙은 진짜 이유 같아요. 디자인 시스템은 많지만, 처음부터 “AI가 읽을 문서”를 같이 만든 곳은 드물거든요. 지난번에 소개한 Impeccable·Hallmark 디자인 스킬이 AI에게 디자인 감각을 가르치는 쪽이었다면, Astryx는 아예 정해진 부품 상자를 쥐여 주는 쪽입니다.

설치는 이렇게

React 19 이상 프로젝트가 있어야 해요(react·react-dom이 필요). 공식 README의 npm 명령은 아래와 같습니다. pnpm, yarn 명령도 문서에 같이 있어요.

npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli

# AI 코딩 도구용 안내문(AGENTS.md) 만들기
npx @astryxdesign/cli init --features agents
Astryx Getting Started 문서, AI에 붙여 넣는 설치 안내와 npm install 명령
AI용 한 줄 안내 + npm 설치 · 출처: Astryx 공식 문서

“Getting Started” 문서에는 AI 코딩 도구에 그대로 붙여 넣는 한 줄 안내도 있어요. 설치부터 안내문 생성까지 AI가 알아서 하게 하는 방식이죠. 설치 전에 그냥 구경만 하고 싶다면 공식 사이트의 Playground가 편해요. 브라우저에서 코드를 고치면 오른쪽에 바로 화면이 나오고, 테마와 템플릿도 골라 볼 수 있습니다.

Astryx Playground, 왼쪽 코드 편집기와 오른쪽 미리보기
설치 없이 브라우저에서 미리 보기 · 출처: Astryx 공식 문서

참고로 이번엔 이 라즈베리파이에서 직접 설치해 돌려 보진 않았어요. 위 내용은 공식 문서와 README 기준입니다.

숫자로 본 다섯 달, 그리고 아직 베타라는 점

공식 블로그의 “One Month of Astryx” 글을 보면 첫 달에 깃허브 별 1만 300개, 포크 758개, core 패키지 19만 회 내려받기, PR을 올린 사람 87명이었어요. 출시 주에는 깃허브 전체 트렌딩 2위까지 올랐다고 하고요. 지금은 별이 그 두 배를 넘었습니다.

Astryx 출시 첫 달과 11월 12일 기준 깃허브 별·npm 내려받기 숫자 표
출시 뒤 숫자로 본 Astryx · 출처: Astryx 공식 블로그·깃허브·npm

다만 아직 0.x 버전의 베타예요. 0.7.0 업데이트 글만 봐도 입력칸 속성 이름이 바뀌는 등 코드를 고쳐야 하는 변경이 들어갔고, 차트 패키지는 정식 버전 없이 canary(시험판)로만 나와 있어요. 깃허브 열린 이슈도 676개입니다. 오래 유지할 회사 서비스라면 1.0 전까지는 버전을 고정해 두고, 업데이트 글을 읽고 올리는 편이 안전해 보여요.

개인적으로는 작은 가게 홈페이지보다는 관리 화면이나 사내 도구를 AI와 같이 빠르게 만들어야 하는 개발자에게 먼저 맞는 도구라고 봐요. 저도 다음엔 AI 에이전트에게 Astryx로 견적 관리 화면 하나를 만들어 보라고 시켜 볼 생각이에요. 여러분은 AI가 만든 화면, 어디까지 믿고 쓰시나요?


출처
· meta/astryx 깃허브 저장소·README
· Introducing Astryx by Meta (공식 블로그, 2026년 6월 18일)
· One Month of Astryx (공식 블로그, 2026년 7월 22일)
· Astryx v0.7.0 업데이트 (공식 블로그, 2026년 10월 12일)
· Working with AI (공식 문서)
· Getting Started (공식 문서)
· @astryxdesign/core npm 페이지
(2026년 11월 12일 확인)

컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.

함께 보면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다