Communitygithub.com

better-ui

표면, 아이콘 및 모션에 대해 테두리 반경, 광학 정렬, 그림자, 아이콘 상태 및 애니메이션의 정확한 값을 제공합니다.

better-ui란 무엇인가요?

이 스킬은 UI 폴리싱을 위한 정확한 값을 정의하여 시각적 일관성을 보장합니다. 상호작용이 올바른 후에 적용되며, 깨진 상호작용보다 우선하지 않습니다. CSS, Tailwind, Framer Motion 등 다양한 플랫폼을 지원하며, 각 값은 근사치가 아닌 정확해야 합니다. 테두리 반경, 그림자, 아이콘 상태 전환, 프레스 스케일, 접근성을 위한 모션 제어 등 세부적인 시각 규칙을 제공합니다. 또한, 고주파 상호작용은 즉각적인 피드백을 제공하고, 저주파 상호작용은 표현적인 모션을 사용하는 등 사용자 경험을 세심하게 개선합니다. 'better-colors', 'better-typography', 'better-accessibility', 'better-layout'과 같은 다른 스킬과 협력하여 종합적인 UI 품질을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Atou4/skillsmith/tree/HEAD/skills/ui-ux/better-ui

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

UI 폴리싱

이 스킬은 표면, 아이콘 및 모션에 대한 시각적 폴리싱을 정확한 값과 함께 제공합니다. 기본 상호작용이 확립된 후에 적용되며, 폴리싱 결과물이 깨진 상호작용보다 우선하지 않습니다.

정확한 값, 선택적 폴리싱

아래 값들은 근사 범위가 아닌 정확한 값입니다. cubic-bezier(0.2, 0, 0, 1)은 cubic-bezier(0.4, 0, 0.2, 1)이 아니며, 0.96은 0.95가 아닙니다. 광학적 보정과 동심 패딩 경계값은 예외입니다. 이들은 시작점이며, 눈으로 판단합니다.

프로젝트의 컴포넌트 라이브러리, 토큰 및 밀도를 유지하고, 여기에 규칙이 없는 경우 해당 모션 언어를 따릅니다. 그림자가 없는 스타일과 같이 의도적이고 일관된 프로젝트 관행은 선호도일 뿐 결과물이 아닙니다. 프로젝트 내에서 동일한 세부 사항이 두 가지 방식으로 구현된 경우 결과물입니다.

텍스트 줄바꿈, 글꼴 렌더링, 표 형식 숫자 및 텍스트 간격은 better-typography에 속합니다. 히트 영역, 키보드 지원, ARIA 및 축소 모션 요구 사항은 better-accessibility에 속합니다. 그룹화, 섹션 간격, 중단점 및 공간 RTL은 방향성 아이콘 미러링을 제외하고 better-layout에 속합니다. 색상 토큰 및 대비 측정은 better-colors에 속합니다.

외부 반경은 내부 반경 더하기 패딩과 같음

중첩된 표면이 보이는 균일한 내부 여백을 공유하는 경우, 외부 반경은 내부 반경에 패딩과 테두리 너비를 더한 값입니다. 패딩이 24px를 초과하거나 의도적으로 비대칭인 경우, 레이어를 별도의 표면으로 처리하고 각각의 반경 토큰을 유지합니다. 레시피는 surfaces.md에 있습니다.

기하학적으로 보기 좋지 않은 경우 광학적으로 정렬

기하학적 중앙 정렬이 어색해 보이는 경우, 눈으로 조정합니다. 버튼의 아이콘 쪽 패딩을 2px 줄이고, 재생 삼각형을 끝점 쪽으로 이동시키며, SVG 자체에서 비대칭 글리프를 수정합니다. 레시피는 surfaces.md에 있습니다.

입체감을 위한 그림자, 구조를 위한 테두리

테두리가 깊이를 만들기 위해서만 존재하는 경우, 이를 투명한 레이어 box-shadow 값으로 대체합니다. 구분선, 분리선, 테이블 셀 및 선택된 상태에는 테두리를 유지합니다. better-accessibility 하에 3:1 비텍스트 대비가 필요한 양식 입력에도 테두리를 유지합니다. 포커스 링도 better-accessibility에 속합니다.

강제 색상 모드는 모든 box-shadow를 제거합니다. 그림자 링 아래에 border: 1px solid transparent를 유지하여 해당 모드에서도 가장자리를 그릴 수 있도록 합니다. 레시피는 surfaces.md에 있습니다.

순수 검정 또는 흰색으로 이미지 외곽선 그리기

콘텐츠 이미지에 1px 내부 여백으로 1px 외곽선을 지정합니다. 라이트 모드에서는 oklch(0 0 0 / 0.1)을, 다크 모드에서는 oklch(1 0 0 / 0.1)을 사용합니다. 거의 검정색 팔레트, 색조 중립색 또는 강조 색상은 절대 사용하지 마세요. 색조가 이미지 가장자리에 착색된 프린지로 나타나기 때문입니다. 로고 및 일러스트레이션과 같은 투명 아트워크는 건너뜁니다. 레시피는 surfaces.md에 있습니다.

상호작용 상태 전환에는 키프레임이 아닌 전환 사용

CSS 전환이나 모션 라이브러리의 스프링을 사용하여 상호작용 상태 변화를 구동합니다. 이는 사용자가 도중에 방향을 바꾸면 다시 타겟팅됩니다. 키프레임은 고정된 타임라인을 실행하며 되돌릴 수 없으므로 한 번 실행되는 시퀀스에만 사용합니다. animations.md를 참조하세요.

프레스 스케일을 0.96으로

눌린 버튼은 150ms 동안 ease-out으로 0.96으로 축소되며, 비활성화된 버튼은 절대 축소되지 않습니다. 모션이 주의를 산만하게 할 수 있는 경우 컴포넌트의 기존 변형 API 또는 static prop을 통해 옵트아웃을 제공합니다. CSS, Tailwind 및 Motion에 대한 레시피를 참조하세요.

고빈도 상호작용은 즉시 응답

키 입력, 행 호버 및 탭 전환은 즉각적인 피드백을 받거나 opacity 또는 background-color에 대해 150ms 이하의 전환을 받습니다. 표현적 모션은 뷰의 첫 로드, 성공 상태 또는 빈 상태와 같은 드문 순간에 사용합니다.

모든 애니메이션 상태 변경은 색상, 아이콘 또는 레이블 형태의 정적 단서도 남깁니다. 모션은 절대 유일한 피드백 채널이 아닙니다.

축소 모션 기본 설정 뒤에 모션 게이트

better-accessibility가 요구 사항을 소유하며, 여기에 있는 어떤 레시피도 이를 포함하지 않고 배포되지 않습니다. prefers-reduced-motion: no-preference에서만 이동, 스케일 및 흐림 효과를 실행합니다. 축소 모션에서는 요소를 즉시 제거하는 대신 불투명도 크로스페이드로 대체합니다. CSS, Tailwind 및 Motion에 대한 레시피는 animations.md에 있습니다.

드문 진입을 100ms 간격으로 지연

시퀀스가 단계적 진입에서 계층 구조를 전달하는 경우, 콘텐츠를 제목, 설명 및 작업과 같은 의미 있는 청크로 분할합니다. 100ms 간격으로 지연시키고, 각각 300ms 동안 ease-out으로 불투명도, 4px 흐림 및 12px translateY로 진입합니다. 일상적인 상호작용은 절대 지연시키지 않습니다. enter-exit.md를 참조하세요.

종료는 진입보다 짧고 작게

150ms 동안 ease-out으로 불투명도, 4px 흐림 및 고정된 -12px translateY로 종료하며, 절대 전체 컨테이너 높이를 사용하지 않습니다. 서랍이 닫히는 것과 같이 대상이 의미를 전달하는 경우에만 완전히 밀어냅니다. 모션이 정보를 추가하지 않는 경우 요소를 즉시 제거합니다. enter-exit.md를 참조하세요.

첫 렌더링 시 상태 애니메이션 건너뛰기

상태 전환을 감싸는 AnimatePresence에 initial={false}를 설정하여 기본 상태가 마운트 시 애니메이션되지 않도록 합니다. 단계적 히어로와 같은 의도적인 진입 주변에는 절대 설정하지 마세요. animations.md를 참조하세요.

컨텍스트 아이콘을 정확한 값으로 크로스페이드

아이콘이 드문 상태 변경(예: 재생에서 일시 정지, 복사에서 복사됨) 시 교체되는 경우 크로스페이드합니다. 스케일은 0.25에서 1, 불투명도는 0에서 1, 흐림은 4px에서 0px로 실행됩니다. 모션 라이브러리를 사용하는 경우 { type: "spring", duration: 0.3, bounce: 0 }을 사용하며, 바운스는 항상 0입니다. 없는 경우, 두 아이콘을 모두 DOM에 유지하고 300ms 동안 cubic-bezier(0.2, 0, 0, 1)로 크로스페이드합니다.

탭의 아이콘 교체와 호버 시 행이 표시하는 작업은 고빈도 상호작용은 즉시 응답에 해당합니다. 두 레시피 모두 icon-transitions.md에 있습니다.

테마 전환 시 전환 억제

테마 전환 중에는 모든 전환을 비활성화하고, 스타일 플러시를 강제로 실행한 후 다음 프레임 후에 전환을 복원합니다. 그렇지 않으면 모든 색상 전환이 한 번에 발생하여 전환이 번집니다. 레시피를 참조하세요.

변경된 부분만 전환

transition-property: scale, opacity와 같이 정확한 속성을 지정하고 all은 절대 사용하지 마세요. performance.md를 참조하세요.

will-change에 애니메이션 속성 이름 지정

첫 프레임에서 버벅거림이 확인된 후에만 will-change를 추가하고, 애니메이션화하는 속성의 이름을 지정합니다: scale의 경우 scale, transform의 경우 transform. 변환 속성, opacity 및 filter로 제한하고 all은 절대 사용하지 마세요. performance.md를 참조하세요.

호버 효과는 호버 가능한 포인터에만 적용

호버 전용 스타일은 @media (hover: hover) 뒤에 배치합니다. 터치에서는 :hover가 탭 후에 고정되어 선택된 상태처럼 보입니다. Tailwind 4의 hover: 변형은 이미 해당 쿼리에서 컴파일되지만 Tailwind 3는 그렇지 않습니다. 컨트롤이 자체 눌린 상태를 그리는 경우 -webkit-tap-highlight-color: transparent를 설정하여 기본 회색 섬광이 중복되지 않도록 합니다.

오버레이 내 스크롤 제한

스크롤 가능한 대화상자, 서랍, 메뉴 및 사이드 패널에 overscroll-behavior: contain을 지정하여 끝까지 스크롤해도 뒤의 페이지가 스크롤되지 않도록 합니다.

아이콘 선 두께를 텍스트 무게와 일치

아이콘의 렌더링된 선 두께는 옆에 있는 텍스트의 두께를 따르며, 400에서 1.5px에서 700에서 2.5px까지입니다. 표면당 하나의 아이콘 라이브러리를 사용합니다. 표, 크기 및 그리드 규칙은 icons.md에 있습니다.

하나의 SVG를 상태별로 다시 색칠

아이콘은 currentColor를 사용하며 호버, 선택 및 비활성화 상태를 별도의 에셋이 아닌 CSS 색상 및 불투명도에서 가져옵니다. 윤곽선이 기본 변형이며, 채우기가 활성 상태를 표시합니다. dir="rtl"에서는 읽기 방향을 따르는 아이콘만 미러링합니다. icons.md를 참조하세요.

완료 전 확인

감지수정
동일한 rounded-* 또는 border-radius를 가진 패딩된 부모와 자식외부 반경에 패딩 추가
옆에 border가 없는 box-shadow: 0 0 0 1px 링border: 1px solid transparent
img에 outline-slate-*, outline-zinc-* 또는 16진수 외곽선 색상outline-black/10 및 dark:outline-white/10
transition-all 또는 transition: all변경되는 속성 이름 지정
:hover, .open 또는 다른 토글 클래스에 설정된 animation:동일한 속성에 대한 전환
active:scale-95, scale-90 또는 0.96 미만의 whileTap0.96
:disabled 제외 항목이 없는 :active 스케일enabled:active: 또는 :not(:disabled):active
0 이외의 값으로 설정된 bounce:bounce: 0
animation으로만 표시되는 기본 규칙의 opacity: 0from 키프레임의 숨겨진 상태, animation-fill-mode: both
prefers-reduced-motion, motion-safe: 또는 MotionConfig 가드가 없는 translate, scale, filter 또는 motion.* 애니메이션게이트를 설정하고 축소 모션에서 불투명도 크로스페이드
disableTransitionOnChange 또는 재정의 없이 색상 전환 및 테마 토글테마 전환 억제 레시피
will-change: all 또는 절대 애니메이션되지 않는 요소의 will-change애니메이션 속성 이름 지정 또는 삭제
아이콘 SVG 내부의 fill="#..." 또는 stroke="#..."currentColor
@media (hover: hover) 외부의 일반 CSS :hover 또는 Tailwind 3 hover:쿼리로 감싸기
overscroll-behavior 없이 대화상자, 서랍 또는 메뉴의 overflow: auto 또는 overflow-y-autooverscroll-behavior: contain

보고

심각도. HIGH는 상호작용을 손상시킵니다(예: 되돌릴 수 없는 키프레임 토글, 터치에 고정된 호버 상태). better-interface의 두 가지 에스컬레이션 트리거가 여기에 해당하며 HIGH로 간주됩니다. 하나는 prefers-reduced-motion을 무시하는 모션, 다른 하나는 모션만으로 전달되는 상태 변경입니다. MEDIUM은 표면, 아이콘 또는 모션의 눈에 띄는 불일치입니다. LOW는 고립된 폴리싱입니다.

확인. 브라우저 없이도 코드에서 컴포넌트가 정의하는 모든 상태(호버, 눌림, 선택됨, 로딩, 빈 상태 등)와 지속 시간 및 이징을 읽습니다. 브라우저를 사용하는 경우 각 상태를 탐색하고 브라우저의 애니메이션 패널에서 10% 속도로 모션을 재생합니다. 실행할 수 없었던 모든 검사는 확인되지 않음으로 보고합니다.

형식. 각각이 위반하는 원칙 아래에 결과를 그룹화하고, 심각도 순서로 정렬하며, 나타나는 모든 위치를 나열하는 하나의 행당 하나의 근본 원인으로 구성합니다:

심각도위치전후이유

위치는 경로/파일:줄입니다. 이유는 원칙과 사용자 영향을 나타냅니다.

HIGH가 남아 있으면 차단됨으로 종료하고, 그렇지 않으면 승인으로 종료하며, 나머지는 테이블에 작업으로 남깁니다. 검사하지 않은 범위를 절대 승인하지 마세요. 보고할 내용이 없으면 "실행 가능한 UI 폴리싱 결과 없음"을 명시하고 확인을 보고합니다.

관련 스킬