본문으로 건너뛰기
zest/ui

패턴

App Shell

왼쪽 내비 240/64 + 상단바. 768px 아래는 드로어.

설치

shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.

npx shadcn@latest add @zest/app-shell

패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내

사용법

import { AppShell } from '@/components/zest/app-shell'

위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.

API

prop타입설명
logoReactNode—
navAppNavItem[]—
navFooter?ReactNode사이드바 아래쪽(내 프로필·로그아웃 등)
topbarRight?ReactNode상단바 오른쪽(검색·알림·프로필) — 있으면 상단바를 그린다
collapsed?boolean—
onCollapsedChange?((collapsed: boolean) => void)—
layout?"auto" | "desktop" | "mobile"auto = 768px 기준 자동. 테스트·미리보기용 강제 지정 가능
childrenReactNode—

표에 없는 HTML·Radix 속성은 그대로 전달돼요.

접근성

폭이 바뀌어도 본문이 다시 마운트되지 않는다.