본문으로 건너뛰기
zest/ui

설치

두 가지 방법이 있어요. 소스를 프로젝트에 가져오는 레지스트리(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/table

shadcn을 처음 쓴다면 먼저 초기화해요.

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로 만들기에서 규칙 파일을 설치하세요.