원문: https://github.com/facebook/astryx/wiki/Home · 번역 기준: 2026-09-03

Astryx는 내부 도구를 만들기 위한 design system입니다. 이 위키는 그 이면의 아키텍처, 컨벤션, 프로토콜을 문서화합니다.

아래 각 섹션은 가장 먼저 필요한 페이지들을 링크합니다. 더 깊은 자료는 여기가 아니라 그 페이지들에서 링크됩니다.

시작하기

• Astryx Philosophy — Astryx가 왜 존재하는지, 우리가 무엇을 배웠는지, 그리고 그 과정에서 도출된 원칙들
• Contributing with AI Assistants — Navi 또는 다른 AI 어시스턴트와 함께 기여하는 방법. 처음이라면 여기서 시작하세요.
• Contributing — 기여가 어떻게 진행되는지, 우리가 무엇을 받아들이는지, RFC 프로세스, 그리고 무엇을 기대할 수 있는지

아키텍처

• System Architecture — 커스터마이징 레이어, token, AI-native 설계
• Architecture Cheat Sheet — 작성자와 리뷰어를 위한 최소 컴포넌트 템플릿과 공유 시스템 lookup
• Theming Infrastructure — defineTheme, CSS custom properties, layer 순서, 서브컴포넌트 override
• Distribution — 패키지, 버저닝, source 및 dist 번들, 사전 컴파일된 CSS

더 깊은 내용: Container Padding System · Chart System Architecture · Docsite Architecture · Why StyleX · RSC Compatibility

컴포넌트 만들기

• Component Lifecycle — 엔드투엔드 가이드: specification → build → hardening → maintenance. 개별 프로토콜들은 이 문서에서 링크됩니다.
• Component Authoring Guide — 파일 구조, StyleX 패턴, token 사용법, 그리고 컨벤션
• API Conventions — 모든 컴포넌트에 적용되는 네이밍, props, 컴포지션, 스타일링 컨벤션
• Design Conventions — 시각 및 인터랙션 컨벤션: token 선택 이면의 의도, 상태 표현, 그리고 디자인 품질을 평가하는 방법

품질

• Component Audit Rubric — 등급이 매겨진 체크리스트: 가중치가 부여된 열한 개 섹션과 무엇이 증거로 인정되는지. PR을 리뷰하시나요? 변경 리뷰에 대한 이 문서의 가이드는 변경 유형별로 기준을 정하며, diff에 대해 전체 체크리스트를 실행하는 일은 결코 없습니다.