기준 UI
AI 생성 인터페이스의 형편없는 디자인을 방지하기 위해 독단적인 UI 기준을 적용합니다.
사용 방법
-
/baseline-ui이 대화에서 UI 작업에 이 제약 조건들을 적용합니다. -
/baseline-ui <file>아래 모든 제약 조건에 대해 파일을 검토하고 다음을 출력합니다:- 위반 사항 (정확한 줄/코드 조각 인용)
- 중요한 이유 (짧은 문장 1개)
- 구체적인 수정 방법 (코드 수준 제안)
스택
- 사용자 지정 값이 이미 존재하거나 명시적으로 요청되지 않은 경우 Tailwind CSS 기본값을 반드시 사용해야 합니다.
- JavaScript 애니메이션이 필요한 경우
motion/react(이전framer-motion)를 반드시 사용해야 합니다. - Tailwind CSS에서 진입 및 마이크로 애니메이션에는
tw-animate-css를 사용하는 것이 좋습니다. - 클래스 로직에는
cn유틸리티(clsx+tailwind-merge)를 반드시 사용해야 합니다.
컴포넌트
- 키보드 또는 포커스 동작이 있는 모든 항목에는 접근성 있는 컴포넌트 프리미티브를 반드시 사용해야 합니다 (
Base UI,React Aria,Radix). - 프로젝트의 기존 컴포넌트 프리미티브를 반드시 먼저 사용해야 합니다.
- 동일한 상호작용 표면 내에서 프리미티브 시스템을 절대 혼합하지 마십시오.
- 스택과 호환된다면 새로운 프리미티브에는
Base UI를 사용하는 것이 좋습니다. - 아이콘 전용 버튼에는
aria-label을 반드시 추가해야 합니다. - 명시적으로 요청되지 않는 한 키보드 또는 포커스 동작을 수동으로 절대 다시 구현하지 마십시오.
상호작용
- 파괴적이거나 되돌릴 수 없는 작업에는
AlertDialog를 반드시 사용해야 합니다. - 로딩 상태에는 구조적 스켈레톤을 사용하는 것이 좋습니다.
h-screen을 절대 사용하지 말고h-dvh를 사용하십시오.- 고정 요소에는
safe-area-inset을 반드시 준수해야 합니다. - 오류는 작업이 발생한 위치 바로 옆에 반드시 표시해야 합니다.
input또는textarea요소에서 붙여넣기를 절대 차단하지 마십시오.
애니메이션
- 명시적으로 요청되지 않는 한 애니메이션을 절대 추가하지 마십시오.
- 컴포지터 속성(
transform,opacity)만 반드시 애니메이션 처리해야 합니다. - 레이아웃 속성(
width,height,top,left,margin,padding)을 절대 애니메이션 처리하지 마십시오. - 작은 로컬 UI(텍스트, 아이콘)를 제외하고 페인트 속성(
background,color) 애니메이션은 피하는 것이 좋습니다. - 진입 시에는
ease-out을 사용하는 것이 좋습니다. - 상호작용 피드백에
200ms를 절대 초과하지 마십시오. - 화면 밖으로 나갈 때는 루핑 애니메이션을 반드시 일시 중지해야 합니다.
prefers-reduced-motion을 존중하는 것이 좋습니다.- 명시적으로 요청되지 않는 한 사용자 정의 이징 곡선을 절대 도입하지 마십시오.
- 큰 이미지나 전체 화면 표면을 애니메이션 처리하는 것은 피하는 것이 좋습니다.
타이포그래피
- 제목에는
text-balance를, 본문/단락에는text-pretty를 반드시 사용해야 합니다. - 데이터에는
tabular-nums를 반드시 사용해야 합니다. - 조밀한 UI에는
truncate또는line-clamp를 사용하는 것이 좋습니다. - 명시적으로 요청되지 않는 한
letter-spacing(tracking-*)을 절대 수정하지 마십시오.
레이아웃
- 고정된
z-index척도를 반드시 사용해야 합니다 (임의의z-*사용 금지). - 정사각형 요소에는
w-*+h-*대신size-*를 사용하는 것이 좋습니다.
성능
- 큰
blur()또는backdrop-filter표면을 절대 애니메이션 처리하지 마십시오. - 활성 애니메이션 외부에서
will-change를 절대 적용하지 마십시오. - 렌더링 로직으로 표현할 수 있는 것에
useEffect를 절대 사용하지 마십시오.
디자인
- 명시적으로 요청되지 않는 한 그라디언트를 절대 사용하지 마십시오.
- 보라색 또는 다색 그라디언트를 절대 사용하지 마십시오.
- 글로우 효과를 기본 어포던스로 절대 사용하지 마십시오.
- 명시적으로 요청되지 않는 한 Tailwind CSS 기본 그림자 척도를 사용하는 것이 좋습니다.
- 빈 상태에는 반드시 명확한 다음 작업 하나를 제공해야 합니다.
- 뷰당 강조 색상 사용을 하나로 제한하는 것이 좋습니다.
- 새로운 색상 토큰을 도입하기 전에 기존 테마 또는 Tailwind CSS 색상 토큰을 먼저 사용하는 것이 좋습니다.