# ZEST UI > ZEST UI — AI native Team을 위한 디자인 시스템. 사람과 AI 에이전트가 같은 부품·규칙으로 화면을 만든다. 무채색 바탕에 강조색 하나(기본 그린 #03C75A). React 19 + Radix + Tailwind v4. MIT. shadcn 레지스트리 @zest = https://ui.zest.im/r/{name}.json 규칙: 색은 토큰 클래스만(text-ink-*, bg-surface, bg-brand), 상태는 StatusDot(점+글자), 페이지는 PageHeader→탭→FilterBar→본문, 상세는 Drawer, 주 버튼은 하나, 그라데이션·보라/파랑 강조색·이모지 제목·카드 그림자 금지. 검사: node scripts/zest-check.mjs src ## 시작하기 - [소개](https://ui.zest.im/docs) - [설치](https://ui.zest.im/docs/installation) - [AI로 만들기](https://ui.zest.im/docs/ai) - [테마 · 강조색](https://ui.zest.im/docs/theming) - [다크 모드](https://ui.zest.im/docs/dark-mode) - [변경 기록](https://ui.zest.im/docs/changelog) ## 기초 - [원칙](https://ui.zest.im/docs/principles) - [색](https://ui.zest.im/docs/colors) - [타이포그래피](https://ui.zest.im/docs/typography) - [간격 · 모서리](https://ui.zest.im/docs/spacing) ## 컴포넌트 - [Accordion](https://ui.zest.im/docs/components/accordion): 질문·답변처럼 접었다 펴는 목록. — `npx shadcn add @zest/accordion` - [Alert](https://ui.zest.im/docs/components/alert): 화면 안 안내 배너. 반려·오류만 즉시 낭독한다. — `npx shadcn add @zest/alert` - [Alert Dialog](https://ui.zest.im/docs/components/alert-dialog): 되돌릴 수 없는 행동을 확인한다. 첫 포커스는 취소. — `npx shadcn add @zest/alert-dialog` - [Avatar](https://ui.zest.im/docs/components/avatar): 라운드 사각 아바타. 사진이 없으면 이름 이니셜 + 파스텔. — `npx shadcn add @zest/avatar` - [Badge](https://ui.zest.im/docs/components/badge): 재직·퇴직 예정·NEW 같은 분류 표시. 긴 글은 말줄임. — `npx shadcn add @zest/badge` - [Breadcrumb](https://ui.zest.im/docs/components/breadcrumb): 현재 위치. 마지막 항목이 현재 페이지. — `npx shadcn add @zest/breadcrumb` - [Button](https://ui.zest.im/docs/components/button): 주·보조·외곽·고스트·위험 5종, 3크기. 주 버튼은 화면에 하나. — `npx shadcn add @zest/button` - [Button Group](https://ui.zest.im/docs/components/button-group): 버튼을 붙여 묶는다. — `npx shadcn add @zest/button-group` - [Calendar](https://ui.zest.im/docs/components/calendar): 한국어 달력. 주말 레드, 오늘 그린 테두리. — `npx shadcn add @zest/calendar` - [Card](https://ui.zest.im/docs/components/card): 1px 테두리 카드. 그림자 없음. — `npx shadcn add @zest/card` - [Checkbox](https://ui.zest.im/docs/components/checkbox): 체크박스. 부분 선택(indeterminate) 지원. — `npx shadcn add @zest/checkbox` - [Collapsible](https://ui.zest.im/docs/components/collapsible): 한 칸만 접었다 편다. — `npx shadcn add @zest/collapsible` - [Combobox](https://ui.zest.im/docs/components/combobox): 검색할 수 있는 선택. 단일·다중. — `npx shadcn add @zest/combobox` - [Command](https://ui.zest.im/docs/components/command): 명령 팔레트(⌘K)와 검색 목록. — `npx shadcn add @zest/command` - [Context Menu](https://ui.zest.im/docs/components/context-menu): 오른쪽 클릭 메뉴. — `npx shadcn add @zest/context-menu` - [Date Picker](https://ui.zest.im/docs/components/date-picker): 날짜 하나 고르기. — `npx shadcn add @zest/date-picker` - [Date Range Picker](https://ui.zest.im/docs/components/date-range-picker): 기간 고르기 — 「11. 18 – 11. 21 · 4일」. — `npx shadcn add @zest/date-range-picker` - [Dialog](https://ui.zest.im/docs/components/dialog): 가운데 모달. — `npx shadcn add @zest/dialog` - [Drawer](https://ui.zest.im/docs/components/drawer): 오른쪽 상세 패널. aside 에 승인 단계를 둔다. — `npx shadcn add @zest/drawer` - [Dropdown Menu](https://ui.zest.im/docs/components/dropdown-menu): 더보기 메뉴. — `npx shadcn add @zest/dropdown-menu` - [Empty State](https://ui.zest.im/docs/components/empty-state): 비어 있을 때 다음 행동을 안내한다. — `npx shadcn add @zest/empty-state` - [Field](https://ui.zest.im/docs/components/field): 라벨·안내·오류를 입력에 연결한다. — `npx shadcn add @zest/field` - [File Dropzone](https://ui.zest.im/docs/components/file-dropzone): 파일 끌어 놓기·선택. 형식·크기 검증. — `npx shadcn add @zest/file-dropzone` - [Form](https://ui.zest.im/docs/components/form): react-hook-form + zod 연결. — `npx shadcn add @zest/form` - [Hover Card](https://ui.zest.im/docs/components/hover-card): 사람·문서 미리보기 카드. — `npx shadcn add @zest/hover-card` - [Icon Button](https://ui.zest.im/docs/components/icon-button): 아이콘만 있는 버튼. aria-label 필수. — `npx shadcn add @zest/icon-button` - [Input](https://ui.zest.im/docs/components/input): 입력칸. 앞 아이콘·뒤 슬롯. — `npx shadcn add @zest/input` - [Input Group](https://ui.zest.im/docs/components/input-group): 입력칸 앞뒤에 단위·아이콘·버튼. — `npx shadcn add @zest/input-group` - [Kbd](https://ui.zest.im/docs/components/kbd): 키보드 키 표기. — `npx shadcn add @zest/kbd` - [Label](https://ui.zest.im/docs/components/label): 입력 라벨. — `npx shadcn add @zest/label` - [Number Input](https://ui.zest.im/docs/components/number-input): 숫자 입력. ↑↓·± 버튼, 범위 고정, 천 단위 쉼표. — `npx shadcn add @zest/number-input` - [Pagination](https://ui.zest.im/docs/components/pagination): 페이지 이동. 한 페이지면 그리지 않는다. — `npx shadcn add @zest/pagination` - [Popover](https://ui.zest.im/docs/components/popover): 버튼 옆에 뜨는 작은 패널. — `npx shadcn add @zest/popover` - [Progress](https://ui.zest.im/docs/components/progress): 진행률 막대. — `npx shadcn add @zest/progress` - [Radio Group](https://ui.zest.im/docs/components/radio-group): 하나만 고르기. — `npx shadcn add @zest/radio-group` - [Scroll Area](https://ui.zest.im/docs/components/scroll-area): 얇은 스크롤바 영역. — `npx shadcn add @zest/scroll-area` - [Segmented Control](https://ui.zest.im/docs/components/segmented-control): 주/월 같은 보기 전환. — `npx shadcn add @zest/segmented-control` - [Select](https://ui.zest.im/docs/components/select): 단일 선택. — `npx shadcn add @zest/select` - [Separator](https://ui.zest.im/docs/components/separator): 구분선. — `npx shadcn add @zest/separator` - [Skeleton](https://ui.zest.im/docs/components/skeleton): 불러오는 동안의 자리표시. — `npx shadcn add @zest/skeleton` - [Slider](https://ui.zest.im/docs/components/slider): 범위 값 고르기. — `npx shadcn add @zest/slider` - [Spinner](https://ui.zest.im/docs/components/spinner): 불러오는 중 표시. — `npx shadcn add @zest/spinner` - [Status Dot](https://ui.zest.im/docs/components/status-dot): 상태 = 점 + 글자. 진행 중·완료·대기·반려·예정. — `npx shadcn add @zest/status-dot` - [Stepper](https://ui.zest.im/docs/components/stepper): 단계 진행(입사 절차 등). — `npx shadcn add @zest/stepper` - [Switch](https://ui.zest.im/docs/components/switch): 켜고 끄기. — `npx shadcn add @zest/switch` - [Data Table](https://ui.zest.im/docs/components/table): 선택·고정 헤더·말줄임·빈 상태를 갖춘 표. — `npx shadcn add @zest/table` - [Tabs](https://ui.zest.im/docs/components/tabs): 밑줄형 탭. — `npx shadcn add @zest/tabs` - [Textarea](https://ui.zest.im/docs/components/textarea): 여러 줄 입력. — `npx shadcn add @zest/textarea` - [Time Input](https://ui.zest.im/docs/components/time-input): 시간 입력 — 「905」도 09:05. — `npx shadcn add @zest/time-input` - [Toast](https://ui.zest.im/docs/components/toast): 잠깐 뜨는 알림. toast() 로 띄운다. — `npx shadcn add @zest/toast` - [Toggle](https://ui.zest.im/docs/components/toggle): 켜고 끄는 버튼. — `npx shadcn add @zest/toggle` - [Tooltip](https://ui.zest.im/docs/components/tooltip): 짧은 설명. 키보드 포커스로도 뜬다. — `npx shadcn add @zest/tooltip` - [App Shell](https://ui.zest.im/docs/components/app-shell): 왼쪽 내비 240/64 + 상단바. 768px 아래는 드로어. — `npx shadcn add @zest/app-shell` - [Page Header](https://ui.zest.im/docs/components/page-header): 큰 제목 + 회색 형제 + 탭 + 도구 줄. — `npx shadcn add @zest/page-header` - [Filter Bar](https://ui.zest.im/docs/components/filter-bar): 필터 칩 줄 + 결과 수 + 보기 저장. — `npx shadcn add @zest/filter-bar` - [Column Settings Panel](https://ui.zest.im/docs/components/column-settings-panel): 표 열 표시·순서 설정(키보드로 이동). — `npx shadcn add @zest/column-settings-panel` - [Profile Header](https://ui.zest.im/docs/components/profile-header): 인사카드 머리 — 커버 띠·아바타·상태. — `npx shadcn add @zest/profile-header` - [Field Grid](https://ui.zest.im/docs/components/field-grid): 라벨-값 4열 격자. 긴 값은 2칸. — `npx shadcn add @zest/field-grid` - [Key Value List](https://ui.zest.im/docs/components/key-value-list): 세로 라벨-값. 변경 전 → 후. — `npx shadcn add @zest/key-value-list` - [Activity Log](https://ui.zest.im/docs/components/activity-log): 처리 이력. — `npx shadcn add @zest/activity-log` - [Approval Steps](https://ui.zest.im/docs/components/approval-steps): 승인·참조 단계 패널. — `npx shadcn add @zest/approval-steps` - [Stat Card](https://ui.zest.im/docs/components/stat-card): 지표 + 증감 + 스파크라인. 좋아졌는지로 색을 정한다. — `npx shadcn add @zest/stat-card` - [Schedule Grid](https://ui.zest.im/docs/components/schedule-grid): 사람 × 날짜 근무표. 이름 열 고정. — `npx shadcn add @zest/schedule-grid` - [로그인](https://ui.zest.im/docs/components/login-block): 가운데 카드 하나. 그라데이션·일러스트 없음. — `npx shadcn add @zest/login-block` - [앱 셸](https://ui.zest.im/docs/components/app-shell-block): 새 화면을 시작하는 틀. — `npx shadcn add @zest/app-shell-block` - [목록](https://ui.zest.im/docs/components/list-block): 필터 칩·선택 표·열 설정. — `npx shadcn add @zest/list-block` - [상세 드로어](https://ui.zest.im/docs/components/detail-drawer-block): 변경 전→후 · 이력 · 승인 단계. — `npx shadcn add @zest/detail-drawer-block` - [대시보드](https://ui.zest.im/docs/components/dashboard-block): 지표 카드 + 근무표. — `npx shadcn add @zest/dashboard-block` - [프로필(인사카드)](https://ui.zest.im/docs/components/profile-block): 프로필 머리 + 탭 + 4열 필드. — `npx shadcn add @zest/profile-block` - [설정](https://ui.zest.im/docs/components/settings-block): 섹션 카드마다 라벨-설명-스위치. — `npx shadcn add @zest/settings-block` - [빈 상태 · 404](https://ui.zest.im/docs/components/empty-block): 비었을 때와 길을 잃었을 때. — `npx shadcn add @zest/empty-block` ## 전체 - [llms-full.txt](https://ui.zest.im/llms-full.txt): 디자인 계약 전문