디자인 & UI
의도적이고 프리미엄처럼 보이는 인터페이스를 만드세요. 템플릿처럼 평범하지 않게요. 이것이 앱 빌더에서 가장 중요한 품질 향상 요소입니다. DOM / 오버레이 UI — 페이지, 크롬, HUD, 메뉴, 폼에 적용하세요. (3D 게임의 게임플레이 캔버스는 building-games 스킬을 참조하세요. 이 스킬은 그 위에 계층화된 DOM UI를 관리합니다.)
상세 내용은 references/를 읽으세요 (필요 시 불러오며, 전부 인라인으로 넣지 마세요):
references/refined-ui.md— 전체 제품-크롬/오버레이 디자인 시스템.references/typography.md— 서체 스케일, 페어링, 리듬.references/surfaces.md— 입면, 테두리, 그림자, 계층.references/animations.md— 모션, 이징, 전환.references/performance.md— UI를 부드럽게 유지 (60fps, 끊김 없음).
1. 디자인 시스템 우선 (스타일링 전에 먼저 하세요)
시스템을 한 번 정의하고, 그로부터 조합하세요. 임의의 값을 여기저기 흩뿌리지 마세요.
- CSS의 토큰 (Tailwind v4는 CSS 우선). 팔레트, 반경, 폰트를
src/styles.css의@theme아래에 CSS 변수로 넣고, Tailwind 유틸리티로 사용하세요. 단일 진실 공급원입니다.@import "tailwindcss"; @theme { --color-bg: #0b0b0f; --color-surface: #16161d; --color-fg: #e7e7ea; --color-muted: #a0a0ab; --color-primary: #14b8a6; --color-border: #26262f; --radius: 0.75rem; --font-sans: "Inter", system-ui, sans-serif; } - shadcn/ui 컴포넌트 사용 (Radix 프리미티브 +
cva변형 +tailwind-merge) — 버튼, 대화상자, 드롭다운, 입력 등에 사용하세요. 접근 가능하고 일관적입니다.src/components/ui에 생성하고 토큰으로 스타일링하세요. 인라인 hex는 사용하지 마세요. - Tailwind v4 기본 수정 — 버튼에 포인터 커서 필요. v4의 Preflight는
<button>에cursor: default를 설정하여 어색하게 만듭니다.src/styles.css에 한 번 추가하여 버튼/클릭 가능한 역할이 포인터를 표시하도록 하세요:@layer base { button:not(:disabled), [role="button"]:not(:disabled) { cursor: pointer; } } - 임의 스타일링 금지: JSX에 원시 hex 사용 금지,
text-white/bg-black리터럴 금지,p-[16px]또는text-[13px]같은 임의 값 금지. 값이 필요하면 토큰이나 스케일 단계로 만드세요.
2. 정량화된 평가 기준 ("못생김"을 방지하는 간단한 규칙)
- 총 3~5색 이하 (기본 색상 1개 + 중성색 + 최대 강조색 1개). 임의의 추가 색조 없음. 요청하지 않으면 기본으로 보라색을 사용하지 마세요.
- 최대 2개 폰트 패밀리 (보통 1개). 제목/표시용과 본문용을 짝짓거나 하나만 사용하세요.
- 줄 높이 1.4~1.6 (본문); 큰 제목은 더 좁게.
- 배경색을 재정의할 때는 전경/텍스트 색상도 함께 재정의하세요 (대비가 유지되어야 함 — 밝은 테마와 어두운 테마 모두 확인).
- 모바일 우선: ~390px 레이아웃을 먼저 디자인하고, 그 다음 확장하세요. 수평 오버플로우 없음; 탭 대상 ≥ 44px.
- 일관된 간격 스케일 (4/8 기준). 넉넉한 여백이 빽빽한 것보다 낫습니다.
- 강조색 하나, 아껴서 사용 — 기본 액션에만, 모든 곳에 사용하지 마세요.
3. AI-슬롭 방지 (출력물이 평범해 보이게 하는 특징 — 피하세요)
- 그라디언트 블롭 채우기 금지, 콘텐츠 대용으로 거대한 히어로 그라디언트 사용 금지.
- 아이콘으로 이모지 사용 금지 — 실제 아이콘 세트(
lucide-react)를 사용하세요. - 손으로 그린 SVG 일러스트레이션/지도/차트 금지 — 실제 라이브러리(
recharts차트) 또는 실제 생성된 이미지를 사용하세요. - 최종 제품에 플레이스홀더 이미지 / 회색 상자 금지 — 실제 이미지를 생성하거나 실제 콘텐츠를 사용하세요; 캔버스 이미지에
crossOrigin="anonymous"를 설정하세요. - 과도하게 사용된 폰트 모양 피하기 (기본 시스템 전용 또는 코믹산스 급 선택).
- 모든 요소는 그 자리를 정당화해야 합니다. 장식적 잡음을 줄이세요. 시스템을 확립하고 의도에 따라 다양화하세요 — 무작위성은 피하세요.
- 앱을 제자리에서 편집할 때 기존 UI와 일치시키세요; 두 번째 시각적 언어를 도입하지 마세요.
4. 레이아웃 & 계층 구조
- 명확한 시각적 계층: 뷰당 하나의 기본 액션; 크기/굵기/색상으로 중요도를 표현하세요.
references/typography.md및references/surfaces.md참조. - 실제 레이아웃 구조 사용 (grid/flex, 컨테이너 최대 너비) — 절대 위치 해킹 사용 금지. 일관된 그리드에 정렬하세요.
- 빈 상태, 로딩 상태, 오류 상태는 디자인의 일부입니다 — 빈/어색한 중간 상태를 제공하지 마세요.
5. 모션 (미묘하고, 목적적)
- 짧고 부드러운 전환 (150~250ms) 호버/누름/진입 시;
prefers-reduced-motion을 존중하세요. 자세한 내용은references/animations.md참조. - 레이아웃을 끊김 현상이 발생하는 방식으로 애니메이션하지 마세요; transform/opacity를 선호하세요.
6. 게임 오버레이 (building-games와 함께 사용 시)
게임플레이 캔버스는 building-games가 소유합니다. 이 스킬은 DOM 오버레이 스타일을 지정합니다: 시작/"클릭하여 플레이" 화면, HUD, 점수, 메뉴, 일시 중지, 모바일 컨트롤. 오버레이를 캔버스 위에서 읽기 쉽게 유지하고 (배경, 대비) 포인터 잠금/게임플레이 입력 경로에서 벗어나게 유지하세요.
완료 체크리스트 (UI 완료 전에 확인하세요)
@theme에 토큰 정의됨; JSX에 임의 hex / 임의 값 없음.- 5색 이하, 2개 폰트 이하, 일관된 간격 스케일.
- 대비 유지됨; 배경이 재정의된 곳마다 전경도 재정의됨.
- 모바일 (~390px)에 오버플로우 없음; 대상 ≥ 44px.
- 실제 아이콘/이미지/차트 — 안티-슬롭 특징 없음.
- 로딩/빈/오류 상태 처리됨; 모션은 미묘하고 축소-모션 안전.
- 브라우저에서 렌더링 및 육안 확인됨 (AGENTS.md 검증 참조), 단순 curl 아님.