Getting Started

AXIS Design System을 프로젝트에 설치하고 사용하는 방법입니다.

Installation

axis-cli를 사용하여 컴포넌트를 설치합니다.

Terminal
npx axis-cli init

Add Components

필요한 컴포넌트를 개별적으로 추가할 수 있습니다.

Terminal
npx axis-cli add button card input

Agentic Components

AI/LLM 애플리케이션용 특수 컴포넌트도 추가할 수 있습니다.

Terminal
npx axis-cli add streaming-text tool-call-card

shadcn/ui Compatibility

100% 호환

AXIS의 Core UI 컴포넌트는 shadcn/ui와 완전히 호환됩니다.

• 동일한 API와 Props 구조

• Tailwind CSS 기반 스타일링

• Radix UI 프리미티브 사용

• 기존 shadcn/ui 프로젝트에 Agentic UI만 추가 가능

CLI Commands

axis-cli는 컴포넌트 설치 외에도 프로젝트 관리를 위한 명령어를 제공합니다.

axis sync

GitHub Issue와 로컬 WI(Work Item) 상태를 동기화합니다.

Terminal
# GitHub Issue와 WI 상태 동기화
npx axis-cli sync

# 변경 사항 미리보기 (실제 변경 없음)
npx axis-cli sync --dry-run

axis status

프로젝트 전체 상태를 요약하여 출력합니다.

Terminal
# 프로젝트 상태 요약 출력
npx axis-cli status