UI 핸들러
지침
1. 표준 컴포넌트(원자) 설치
기본 UI 요소(버튼, 입력 필드, 대화상자)에는 Shadcn MCP를 사용하세요.
- 작업: Shadcn MCP에 컴포넌트 추가를 요청하세요.
"Shadcn MCP를 사용하여 버튼과 대화상자 컴포넌트를 추가하세요."
- 수동 대체:
pnpm dlx shadcn@latest add {component}
2. 복잡한 섹션(블록) 생성
고수준 섹션(랜딩 페이지, 히어로, 대시보드)에는 21st.dev Magic MCP를 사용하세요.
- 작업: 21st.dev MCP에 설명을 입력하세요.
"어두운 그라데이션 배경과 이메일 캡처 양식이 있는 현대적인 SaaS 히어로 섹션을 생성하세요."
- 위치: 생성된 파일은
src/components/sections/또는src/components/website/에 배치하세요. - 통합:
page.tsx에서 가져와서 사용하세요.
3. 테마 및 스타일링
Shadcn MCP를 사용하거나 src/app/globals.css를 직접 편집하세요.
- 테마 업데이트: Shadcn MCP에 특정 테마나 색상 팔레트를 적용하도록 요청하세요.
"앱 테마를 'zinc' 중립 베이스에 'blue' 기본 색상으로 업데이트하세요."
- CSS 변수:
src/app/globals.css에서 CSS 변수(주로 OKLCH)를 사용합니다. 새 스타일은 이러한 변수(예:bg-background,text-primary)를 사용해야 합니다.
4. 레이아웃 생성
- 식별: 헤더, 사이드바, 콘텐츠 영역.
- 구성:
@/components/ui의 원자와@/components/sections의 섹션을 사용하세요. - 동일 위치: 컴포넌트가 특정 페이지에만 고유한 경우 페이지 옆의
_components/에 배치하세요.
참고
자세한 아키텍처 및 모범 사례는 reference.md를 참조하세요.