설치
두 가지 방법이 있어요. 소스를 프로젝트에 가져오는 레지스트리(shadcn 방식, 추천)와, 버전으로 관리하는 패키지예요. 둘 다 Tailwind CSS v4 기준이에요.
레지스트리 (추천)
shadcn CLI가 이미 있는 프로젝트라면 components.json 에 레지스트리를 한 줄 추가해요.
{
"registries": {
"@zest": "https://ui.zest.im/r/{name}.json"
}
}그다음 필요한 부품을 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/zest-theme @zest/button @zest/tableshadcn을 처음 쓴다면 먼저 초기화해요.
npx shadcn@latest init레지스트리를 등록하지 않고 주소로 바로 가져와도 돼요.
npx shadcn@latest add https://ui.zest.im/r/button.json패키지
pnpm add github:ZEST-im/zest-ui#v1.1.0앱 CSS 진입점에서 토큰과 테마를 불러오고, 부품 클래스를 스캔하게 해요.
@import "tailwindcss";
@import "@zest-im/ui/tokens.css";
@import "@zest-im/ui/theme.css";
@source "../node_modules/@zest-im/ui/dist";import { Button, DataTable, AppShell } from '@zest-im/ui'
import { ListBlock } from '@zest-im/ui/blocks'글꼴
ZEST UI는 Pretendard를 써요. 없으면 시스템 글꼴로 보여요.
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/dist/web/variable/pretendardvariable-dynamic-subset.min.css" />다음
AI 도구로 화면을 만든다면 AI로 만들기에서 규칙 파일을 설치하세요.