Meta의 React 디자인 시스템 Astryx를 소개하는 글

웹 디자인이 어렵다면? Meta의 디자인 시스템 Astryx로 시작해 보세요

임고봇IT

기능은 만들었는데 화면이 어딘가 어색해요. 버튼마다 크기가 다르고, 입력창과 카드의 간격도 조금씩 달라요. 색을 바꿔 봐도 정돈된 느낌은 잘 나지 않죠.

이럴 때 필요한 건 새로운 색상 조합보다 ‘함께 쓰도록 설계된 UI 부품과 규칙’일 수 있어요. Meta가 공개한 오픈소스 디자인 시스템 Astryx가 바로 그런 출발점이에요. React 컴포넌트에 테마, 다크 모드, 페이지 템플릿, 개발 도구를 묶어서 제공해요.

다만 버튼 하나로 웹사이트를 완성하는 노코드 서비스는 아니에요. React로 화면을 만드는 사람에게, 매번 디자인의 기본값부터 결정하지 않아도 되는 기반을 제공하는 도구에 가까워요.

Astryx는 어떤 도구인가요?

Astryx는 React와 StyleX를 기반으로 만든 디자인 시스템이에요. Meta의 설명에 따르면, 사내 수천 개의 도구에서 날짜 선택기·테이블·폼 같은 요소를 반복해서 만들던 문제에서 출발했어요. 약 8년간 축적한 내부 시스템의 경험과 규칙을 오픈소스 기술 스택으로 다시 구성한 프로젝트예요. 단순히 사내 코드를 그대로 공개한 것은 아니라는 점도 알아두면 좋아요.

공식 홈페이지는 현재 180개 이상의 컴포넌트를 소개하고 있어요. 개별 UI 요소뿐 아니라 로그인, 설정, 결제 폼, 상품 상세, AI 채팅 같은 페이지 템플릿도 둘러볼 수 있어요. 2026년 11월 18일 기준으로는 베타 단계예요.

디자인이 막힐 때 도움이 되는 세 가지

1. 작은 결정을 처음부터 반복하지 않아도 돼요

Astryx는 타이포그래피, 색상, 레이아웃 같은 기초 규칙과 재사용 가능한 컴포넌트를 함께 제공해요. 테이블 페이지나 상세 화면, 여러 단계로 구성한 폼처럼 자주 등장하는 화면 패턴도 다뤄요.

이런 구성의 장점은 ‘예쁜 버튼 하나’보다 화면 전체의 일관성에서 찾아볼 수 있어요. 예를 들어 회원 관리 페이지를 만든다면, 먼저 다음처럼 필요한 영역을 나눠 보세요.

  • 페이지 제목과 회원 추가 버튼
  • 검색과 필터
  • 회원 목록
  • 데이터가 없거나 불러오기에 실패했을 때의 안내

그다음 각 영역을 같은 시스템의 부품으로 채우는 거예요. 무엇을 어디에 보여줄지에 집중하고, 개별 요소의 스타일 결정은 줄이는 방식이죠.

2. 기본 테마를 쓰되, 내 서비스에 맞게 바꿀 수 있어요

Astryx에는 Neutral, Butter, Matcha, Gothic, Y2K 등 여러 테마가 준비돼 있어요. 공식 테마 탐색기에서는 같은 UI에 다른 테마를 적용한 모습을 살펴볼 수 있고, 마음에 드는 테마를 직접 관리하는 파일로 가져와 수정할 수 있어요.

스타일을 바꾸기 위해 반드시 StyleX를 새로 배워야 하는 것도 아니에요. 기본 사용 경로는 미리 빌드한 CSS를 가져오는 방식이고, className을 통해 Tailwind CSS, CSS Modules, 일반 CSS로 스타일을 덮어쓸 수 있어요. 테마는 CSS 사용자 정의 속성을 기반으로 조정해요.

처음에는 기본 테마를 유지한 채 화면 구조를 완성해 보세요. 이후 브랜드 색상과 글꼴, 둥근 모서리 같은 시각적 요소를 조정하는 편이 작업 범위를 관리하기 좋아요.

3. AI에게도 같은 사용 설명서를 줄 수 있어요

Astryx의 특징 중 하나는 사람과 AI 코딩 에이전트가 같은 문서를 참고하도록 설계했다는 점이에요. CLI에서 컴포넌트 API와 예제, 템플릿, 디자인 규칙을 조회할 수 있어요. init 명령은 AGENTS.md나 CLAUDE.md에 컴포넌트 안내를 추가해, 에이전트가 제공되는 기능을 찾도록 도와줘요.

AI와 작업한다면 요청도 조금 구체적으로 써보세요. 아래는 활용을 위한 프롬프트 예시예요.

Astryx로 회원 관리 화면을 만들어 줘. 먼저 CLI에서 관련 컴포넌트와 템플릿 문서를 확인해 줘. 검색, 상태 필터, 회원 목록, 빈 상태를 포함하고, 기본 테마와 간격 규칙을 우선 사용해 줘.

핵심은 ‘깔끔하게 만들어 줘’에서 끝내지 않고, 어떤 화면인지와 무엇을 확인해야 하는지까지 알려주는 거예요.

또한 2026년 11월 14일에는 v0에서 Astryx를 디자인 시스템 스킬로 사용할 수 있다는 공식 발표도 나왔어요. 프로젝트에 Astryx를 선택하면 관련 가이드, 컴포넌트, 예제, 템플릿을 생성 과정의 문맥에 포함하는 방식이에요.

시작하기: 설치하고, 문서를 확인하고, 한 화면만 만들어 보세요

Astryx는 React 19 이상이 필요해요. 기존 React 프로젝트라면 먼저 버전을 확인한 뒤, 공식 안내에 따라 코어와 테마, 필요한 의존성 및 CLI를 설치해요.

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

설치 후에는 다음 명령으로 초기화하고, 사용할 부품과 템플릿을 찾아볼 수 있어요. npx로 실행할 때는 관계없는 동명 패키지와 혼동하지 않도록 @astryxdesign/cli라는 전체 패키지명을 쓰는 것이 공식 안내예요.

npx @astryxdesign/cli init
npx @astryxdesign/cli component --list
npx @astryxdesign/cli component Button
npx @astryxdesign/cli template --list

화면에 스타일을 적용하려면 CSS와 테마 설정도 필요해요. 예를 들어 기본 Next.js 구성에서는 전역 CSS에 다음 세 파일을 순서대로 가져오고, 앱을 테마 프로바이더로 감싸요. 기본 경로에는 별도의 Astryx 빌드 플러그인이나 Babel·PostCSS 설정이 필요하지 않아요.

@import '@astryxdesign/core/reset.css';
@import '@astryxdesign/core/astryx.css';
@import '@astryxdesign/theme-neutral/theme.css';

프로바이더와 라우터 연결, Tailwind 병행 설정은 프로젝트 환경에 맞춰 공식 코어 README를 따라가세요. 특히 이미 Tailwind를 사용하고 있다면 CSS 레이어 순서까지 확인해야 해요. 위 세 줄만 기존 설정에 무작정 붙이는 방식은 피하는 게 좋아요.

처음부터 서비스 전체를 바꾸기보다 설정 페이지나 간단한 목록 화면 하나를 시험 대상으로 정해 보세요. 실제 데이터와 긴 한국어 문구를 넣고, 좁은 화면에서도 읽기 편한지 살펴보면 내 프로젝트와 잘 맞는지 판단하기 좋아요.

도입 전에 알아둘 점도 있어요

Astryx는 베타이고, 저장소의 모든 패키지가 같은 배포 상태는 아니에요. 공식 README에 따르면 실험용 lab 패키지는 npm에 공개하지 않으며, vega와 charts는 안정 릴리스 없이 canary 태그로만 배포해요. 차트가 핵심인 화면을 계획하고 있다면 필요한 기능의 패키지와 배포 상태를 먼저 확인하세요.

접근성을 고려한 컴포넌트를 제공하지만, 완성한 서비스의 접근성까지 자동으로 보장한다고 받아들이지는 않는 편이 좋아요. 도입 평가 때는 키보드 이동, 입력 항목의 이름, 오류 안내, 색상 대비를 직접 점검할 항목으로 남겨두세요. 컴포넌트 제공 범위와 실제 화면 검토는 구분해서 보는 거예요.

무엇보다 Astryx가 대신 정해주지 않는 질문이 있어요. 사용자가 이 화면에서 가장 먼저 해야 할 일은 무엇인지, 어떤 정보가 중요하고 어떤 정보는 숨겨도 되는지 같은 문제예요. 이 부분은 여전히 만드는 사람이 결정해야 해요.

‘디자인을 맡기는 도구’보다 ‘출발선을 마련하는 도구’

Astryx를 살펴볼 때는 화려한 결과물보다, 내가 반복해서 고민하던 일을 얼마나 덜어주는지 보세요. 버튼과 입력창의 모양을 계속 손보고 있었다면 기본 컴포넌트부터, 페이지 구성이 막혔다면 템플릿부터 확인하면 돼요.

첫 목표는 작게 잡아도 괜찮아요. 기본 테마로 화면 하나를 완성하고, 실제 내용을 채운 뒤, 꼭 필요한 부분만 바꿔 보세요. 빈 화면 앞에서 모든 것을 결정하는 대신, 이미 마련된 기준 위에서 내 서비스에 필요한 판단을 시작하는 거예요.

출처

댓글0

로그인 필요