스타일링 및 UI 성능
우선순위: P1 (높음)
Server Components에는 제로 런타임 CSS를 우선시합니다.
라이브러리 선택
| 라이브러리 | 판정 | 이유 |
|---|---|---|
| Tailwind / shadcn | 선호 (P1) | 제로 런타임, RSC 호환. App Router에 최적입니다. |
| CSS Modules / SCSS | 권장 | 스코프 지정, 제로 런타임. 레거시 프로젝트에 적합합니다. |
| Ant Design | 지원 | RSC를 위해 Client Component 래퍼와 함께 사용하세요. |
| MUI / Chakra (런타임) | 회피 | 광범위하게 use client를 강제합니다. 성능을 저하시킵니다. |
라이브러리 패턴
특정 라이브러리 설정은 다음을 참조하세요:
- references/scss.md
- references/ant-design.md
- references/tailwind.md (Tailwind/shadcn)
패턴
- 동적 클래스:
clsx+tailwind-merge(cn유틸리티)를 사용하세요.- 참조: 동적 클래스 및 버튼 예제
- 폰트 최적화:
next/font를 사용하여 누적 레이아웃 이동(CLS)을 방지하세요.- 참조: 폰트 설정
- CLS 방지: 이미지에 항상
width/height를 지정하세요.
안티패턴
- RSC와 함께 런타임 CSS-in-JS 사용 금지: MUI/Chakra는
'use client'를 강제합니다. Tailwind 또는 CSS Modules를 선호하세요. - 차원 없는
<img>사용 금지: CLS를 방지하려면 항상width/height를 설정하거나fill을 사용하세요. - 하드코딩된 조건부 클래스 사용 금지: 동적 스타일에는
clsx+tailwind-merge(cn)를 사용하세요. - Google Fonts
<link>태그 사용 금지: 제로 CLS 셀프 호스팅 폰트를 위해next/font를 사용하세요.