패턴
App Shell
왼쪽 내비 240/64 + 상단바. 768px 아래는 드로어.
import { CalendarDays, FileText, LayoutDashboard, Users } from 'lucide-react'
import { AppShell } from '@zest/patterns/AppShell.js'
import { PageContainer, PageHeader } from '@zest/patterns/PageHeader.js'
export default function Demo() {
return (
<div className="h-[420px] w-full overflow-hidden rounded-md border border-solid border-line [&>div]:min-h-full">
<AppShell
layout="desktop"
logo={<span className="text-title font-bold text-ink-strong">zest</span>}
nav={[{ href: '#', label: '홈', icon: LayoutDashboard }, { href: '#', label: '구성원', icon: Users, active: true }, { href: '#', label: '근태', icon: CalendarDays }, { href: '#', label: '결재', icon: FileText, badge: 3 }]}
>
<PageContainer><PageHeader title="구성원"><p className="m-0 text-body text-ink-muted">본문</p></PageHeader></PageContainer>
</AppShell>
</div>
)
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/app-shell패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { AppShell } from '@/components/zest/app-shell'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
logo | ReactNode | — |
nav | AppNavItem[] | — |
navFooter? | ReactNode | 사이드바 아래쪽(내 프로필·로그아웃 등) |
topbarRight? | ReactNode | 상단바 오른쪽(검색·알림·프로필) — 있으면 상단바를 그린다 |
collapsed? | boolean | — |
onCollapsedChange? | ((collapsed: boolean) => void) | — |
layout? | "auto" | "desktop" | "mobile" | auto = 768px 기준 자동. 테스트·미리보기용 강제 지정 가능 |
children | ReactNode | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.
접근성
폭이 바뀌어도 본문이 다시 마운트되지 않는다.