Communitygithub.com

ui-craft

모든 소프트웨어(웹 앱, 대시보드, 데스크톱 앱, 모바일 앱, 마케팅 사이트 등)를 위해 프리미엄하고 전문적이며 사용하기 쉬운 인터페이스를 디자인하고 구축합니다.

ui-craft란 무엇인가요?

ui-craft는 다양한 플랫폼에서 사용자 인터페이스를 디자인, 구축, 재스타일링 또는 리뷰할 때 활용하는 AI 에이전트 스킬입니다. 웹 앱, 대시보드, 데스크톱 앱(Mac, Windows, Electron), 모바일 및 태블릿 앱(iOS, Android, Flutter, React Native), 마케팅 사이트 등 모든 소프트웨어를 대상으로 하며, 아트 디렉션(16가지 시각 방향), 색채 이론과 심리학, UX에서의 인간 심리와 감정, 프리미엄 공예 디테일, 플랫폼 규칙, 접근성, 빠른 클라이언트 목업, 기존 제품 점수화를 다룹니다. 사용자가 인터페이스를 더 좋게, 프리미엄하게, 현대적으로, 비싸 보이게, 전문적으로 또는 "AI가 만든 것처럼 보이지 않게" 만들고자 할 때; 색상, 폰트 또는 브랜드 룩을 선택할 때; 클릭 가능한 HTML 목업이나 클라이언트용 디자인 옵션을 제작할 때; 또는 기존 제품을 리뷰, 감사, 점수화 또는 개선해야 할 때 이 스킬을 사용합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, SKILL.md 문서에 정의된 체계적인 워크플로우와 심리학, 프리미엄 공정에 대한 참조 자료를 통해 일관되고 고품질의 UI 디자인 결정을 내릴 수 있도록 지원합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/najeebafridi/ui-craft/tree/HEAD/skills/ui-craft

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

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

문서

ui-craft은(는) 무엇을 하나요?

프리미엄해 보이고 사용하기 쉬운 인터페이스를 모든 플랫폼에서 구축하는 방법. 숫자는 CSS px 기준입니다. 네이티브 앱의 경우 px를 pt(iOS, macOS), dp(Android) 또는 epx(Windows)로 읽습니다.

프리미엄은 네 가지를 의미합니다. 적절함: 대상 사용자, 그들의 마음 상태, 그리고 플랫폼에 맞습니다. 결정됨: 작은 시스템(적은 수의 크기, 하나의 반경 패밀리, 하나의 악센트)이 모든 곳에 적용됩니다. 정교하게 제작됨: 디테일이 완성되었습니다. 정직함: 신뢰를 얻고 절대 속이지 않습니다. 올바르기만 한 화면은 평범해 보이고, 장식만 된 화면은 싸구려처럼 보입니다.

1. 워크플로우 (매번 이렇게 하세요)

  1. 만들기 전에 살펴보세요. 기존 디자인 시스템(토큰, 테마 파일, Tailwind 설정, 컴포넌트 라이브러리, 브랜드 색상, 폰트, 또는 DESIGN.md 브리프와 ui-craft Studio에서 내보낸 theme.css)이 있는지 확인하세요. 있다면 그것을 사용하고, 두 번째 시스템을 만들지 마세요. 빈 부분만 채우세요.
  2. 사람을 이해하세요. 누가 이것을 사용하며, 어떤 마음 상태(서두름, 불안, 회의적, 흐름 속의 전문가)이고, 어떤 기분을 느껴야 합니까? 한 줄로. references/psychology-emotion.md를 참조하세요.
  3. 방향을 선택하세요. 정해진 정체성이 없다면, references/directions.md에서 하나의 시각적 방향을 선택하여 (참신함을 위해서가 아니라) 대상 사용자에게 맞추고, assets/directions/에 있는 해당 파일의 헤더를 읽고, 그 시그니처를 기록하세요. 브랜드 색상이 있다면 방향을 유지하고 색상을 재구축하세요: node <skill-dir>/scripts/palette.mjs --accent "#HEX". 눈으로 선택하는 것을 선호하는 사람들은 ui-craft Studio(https://najeebafridi.github.io/ui-craft/)를 사용할 수 있습니다: 방향을 선택하고, 라이브 화면에서 조정한 후, theme.css와 여러분이 따라야 할 DESIGN.md 브리프를 내보내세요.
  4. 코드 전에 디자인 브리프를 작성하세요. (답변이나 주석에):
    제품: 소기업용 급여 관리 (웹 앱, 데스크톱 우선)
    사용자와 느낌: 밤에 급여 처리를 하는 사업주, 실수에 대한 불안 -> 안전하고, 안내되며, 정확함
    방향: 신뢰받는 장부; 악센트는 딥 틸(그들의 브랜드), 쿨한 중성색, 라이트 테마
    서체: IBM Plex Sans + Mono, 14px 본문, 표 형식 숫자      형태와 깊이: 6px 반경, 부드러운 그림자
    밀도와 모션: 컴팩트, 선명함 (120-200ms)              플랫폼: 반응형 웹
    시그니처: 숫자가 장부처럼 설정됨; 확인은 정확한 금액과 시간을 명시함
    이 화면의 주요 작업: 이번 달 실행을 검토하고 승인하기
    
  5. 먼저 구조를 만들고, 그다음 스타일을 적용하세요. 실제 콘텐츠로 레이아웃과 계층 구조를 만든 다음 시스템(토큰), 그다음 디테일을 만드세요. 로렘 입숨은 사용하지 마세요: 현실적인 이름, 숫자, 카피를 작성하세요. 시그니처를 일찍 구축하고 다른 모든 것은 그것보다 조용하게 유지하세요. 작동하는 모습을 보여주세요. 첫 번째 뷰는 사용 중인 화면입니다: 실제 데이터, 이미 선택된 합리적인 기본값, 주요 상호작용이 보입니다. 절대 모든 것이 비어 있거나 잠긴 상태, 죽은 "$0" 합계, 또는 이전 단계가 완료될 때까지 숨겨진 주요 단계에서 시작하지 마세요.
  6. 모든 상태를 디자인하세요: 로딩, 비어 있음, 오류, 성공, 긴 텍스트, 많은 항목, 하나의 항목, 권한 없음 (references/feedback-states.md).
  7. 마무리하고 확인하세요. references/premium-craft.md에서 마무리 작업을 수행하세요. 그런 다음 결과를 살펴보세요: Node와 Chrome을 사용할 수 있다면, node <skill-dir>/scripts/ui-audit.mjs page.html을 실행하세요. 1440px와 390px에서 대비, 크기, 터치 대상, 오버플로를 점수화하고, 공정 문제를 기록하며, 스크린샷을 저장합니다. 두 스크린샷을 모두 열고 데스크톱 화면만큼 엄격하게 휴대폰 화면도 판단하세요: 잘리거나, 가려지거나, 압착된 부분이 없고, 주요 콘텐츠가 첫 화면에 있어야 합니다. 화면이 하나의 이야기를 전달하는지 확인하세요: 요약이 선택과 일치하고, 합계가 더해지고, 개수가 목록과 일치하며, 날짜가 동의합니다. 보이는 것을 수정한 다음, 기본 작업에 도움이 되지 않는 것은 제거하세요. 체크리스트: references/review-checklist.md.

클라이언트를 위한 빠른 목업: references/mockups.md. 기존 제품 리뷰 또는 점수화: references/review-mode.md.

같은 테마 위의 레이어. 3D 장면, 셰이더, 스크롤 스토리텔링 또는 시네마틱 모션의 경우, immersive-web 스킬(동일 플러그인)을 사용하세요: 이 스킬은 동일한 토큰을 읽으며, 테마의 --immersive 수준(0 정적에서 3 스토리까지)이 얼마나 멀리 갈지 결정합니다. 다른 장르나 매체(게임, SF, 영화)의 룩을 차용하려면 references/mixing.md를 읽으세요.

2. 제품 유형별 밀도

제품본문 텍스트밀도내비게이션
데이터 도구, 관리자, 개발 도구, 금융14px컴팩트: 행 36px, 컨트롤 32-36px왼쪽 사이드바 220-280px
SaaS 웹 앱14-16px표준: 컨트롤 36-40px사이드바 또는 상단 바
대시보드, 분석14px컴팩트사이드바 + 필터 바
마케팅, 랜딩 페이지16-18px여유: 섹션 간격 64-96px상단 바, 4-6개 링크 + 1개 액션
모바일 앱16-17px터치: 타겟 44px 이상하단 탭 바, 3-5개 항목
데스크톱 앱13-14px (플랫폼 기본값)컴팩트사이드바 + 툴바; OS 따름
소비자, 유쾌함16px표준플랫폼 기준

본문 텍스트 기본값은 16px입니다. 밀집된 데스크톱 도구에서만 14px를 사용합니다. 절대 12px 미만으로 내려가지 마세요. 컴팩트 밀도는 마우스와 키보드 전용입니다: 터치 화면에서는 모든 컨트롤이 44px로 커집니다(§13).

3. 계층 구조 (가장 큰 이점)

  • 화면당 하나의 히어로와 하나의 주요 작업. 주요 작업은 유일한 솔리드 악센트 버튼입니다. 다른 버튼은 아웃라인, 서브틀 또는 텍스트 버튼입니다.
  • 크기, 두께 및 색상을 함께 사용하여 계층 구조를 만듭니다. 제목을 돋보이게 하려면 제목을 키우는 대신 레이블과 메타 텍스트를 조용하게 만듭니다.
  • 레이블은 값보다 조용합니다. "매출 $48,210"에서 레이블은 12-14px 희미하게, 값은 24px 세미볼드로 표시합니다.
  • 간격을 먼저, 그다음 배경 색조, 그다음 선, 마지막으로 그림자로 그룹화합니다. 그룹 간 간격은 그룹 내 간격의 최소 두 배입니다. 상자와 선이 적을수록 더 비싸 보입니다.
  • 읽기 순서는 중요도와 일치합니다: 주요 작업은 (좌에서 우로 읽는 언어의 경우) 왼쪽 상단 또는 중앙에 위치합니다.

4. 레이아웃과 간격

  • 간격 척도 (4px 기준): 4, 8, 12, 16, 24, 32, 48, 64, 96. 이것들만 사용합니다.
  • 컴포넌트 내부: 4-12px; 컴포넌트 간: 16-24px; 섹션 간: 32-48px(앱), 64-96px(마케팅).
  • 페이지 측면 패딩: 모바일 16px, 태블릿 24px, 데스크톱 32px 이상. 콘텐츠 최대 너비: 1200-1440px(앱), 1120-1280px(마케팅); 읽기 텍스트는 65-75자.
  • 그리드 또는 flex와 gap을 사용하여 레이아웃을 구성합니다. 양쪽 축으로 정렬합니다: 이웃 요소는 왼쪽 가장자리와 기준선을 공유합니다. 거의 맞는 것은 아마추어처럼 보입니다.
  • 외부 패딩은 최소 내부 간격과 같습니다. 확실하지 않으면 여백을 추가하고 테두리를 제거하세요.
  • 죽은 공간 없음. 더 높은 이웃과 일치시키기 위해 카드를 늘리지 말고(align-items: start), 패널을 대부분 비어 있는 상태로 두지 마세요: 실제 콘텐츠를 제공하거나, 줄이거나, 제거하세요.
  • 밀도는 결정입니다: 여유롭거나 컴팩트하며, 항상 정확합니다. 중단점: 640, 1024, 1440; 최소 375와 1440에서 확인하세요.

세부 사항: references/layout-spacing.md.

5. 타이포그래피

  • 서체 척도: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60 (더 큰 것은 디스플레이 전용). 앱 화면당 4-6개 크기, 마케팅 페이지에서는 최대 7개.
  • 폰트는 방향 또는 브랜드에서 가져옵니다: 앱은 한 패밀리, 최대 두 개(헤딩용 디스플레이 페이스 + 중립적인 텍스트 페이스). 기본값이라는 이유만으로 폰트를 사용하지 마세요. 제안된 모든 폰트는 무료입니다(SIL OFL).
  • 크기에 맞게 서체를 조정하세요. 본문 행간 1.5, 헤딩 1.2-1.3, 디스플레이 1.05-1.15. 자간: 14-16px에서 0, 20-24px에서 약 -0.015em, 30-36px에서 -0.025em, 48px 이상에서 -0.03 ~ -0.04em; 작은 대문자 레이블에서 +0.06em.
  • 두께: 본문 400, 레이블과 버튼 500, 헤딩 600; 큰 디스플레이에서만 700+. 화면당 최대 3개. 호버 시 두께는 절대 변경되지 않습니다.
  • 헤딩에 text-wrap: balance, 문단에 pretty. 변경되거나 정렬되는 모든 숫자에 font-variant-numeric: tabular-nums; 테이블에서 숫자는 오른쪽 정렬.
  • 헤딩, 버튼 및 레이블은 문장형 대소문자 사용. 실제 인용 부호, 대시 및 줄임표 사용.

세부 사항: references/typography.md.

6. 색상

  • 먼저 느낌을 선택하세요. 명도와 채도는 색상보다 화면의 느낌을 더 많이 바꿉니다: 더 밝을수록 더 pleasant하고, 더 채도가 높을수록 더 흥미진진하며, 낮은 채도와 강한 대비는 차분하고 진지합니다. 그런 다음 의미, 카테고리 적합성 및 경쟁사와의 차별화를 위해 색상을 선택하세요. references/color-theory.md.
  • 팔레트는 틴트된 중성색 + 하나의 악센트 + 상태 색상(성공, 경고, 위험, 정보)으로 구성됩니다. 중성색은 (따뜻함, 차가움 또는 브랜드 색상의) 색상 흔적을 지니며, 절대 죽은 회색이 아닙니다. 넓은 영역에 순수한 검정 또는 흰색을 사용하지 마세요.
  • 대부분 중성색. 악센트는 약 5-10%를 차지합니다: 기본 버튼, 링크, 선택, 포커스, 주요 데이터. 높은 채도는 작고 가치 있는 지점에만 사용합니다.
  • scripts/palette.mjs(OKLCH, 라이트 + 다크, 대비를 통과하도록 해결된 모든 텍스트 및 테두리 색상)를 사용하여 구축하거나 방향에서 가져오세요. 절대 눈으로 16진수 값을 만들지 마세요.
  • 컴포넌트에서는 의미론적 토큰만 사용하세요: --bg, --surface, --surface-2, --border, --border-strong, --text, --text-muted, --text-subtle, --accent, --accent-fg, --accent-soft, --accent-text, --focus, --danger… 각 표면에는 전경 파트너가 있습니다.
  • 대비 하한 (WCAG 2.2 AA): 텍스트는 4.5:1, 큰 텍스트(24px+ 또는 18.66px+ 볼드) 및 UI 부품(입력 테두리, 아이콘, 포커스 링, 차트 표시)은 3:1. 구분선은 희미할 수 있으며, 입력 테두리는 --border-strong을 사용합니다.
  • 의미 전달에 색상만 단독으로 사용하지 마세요: 아이콘, 텍스트 또는 모양을 추가하세요. 상태 색상은 브랜드 색상과 분리되어 유지됩니다. 빨간색 브랜드는 오류 색상과 겸용되지 않습니다.
  • 다크 모드는 자체 팔레트입니다: 거의 검은색에 가까운 틴트된 표면, 더 밝은 돌출 표면, 약간 흰색 텍스트, 차분한 악센트. 두 테마를 모두 제공하고 OS를 따르세요.

세부 사항: references/color-theory.md, references/color-dark-mode.md. 토큰: assets/tokens.css, assets/directions/.

7. 빛, 깊이 및 형태

  • 하나의 광원, 위에서, 모든 곳에. 세 가지 수준만: 평평함, 돌출됨(--shadow-raised), 오버레이(--shadow-overlay).
  • 그림자는 레이어드되고 틴트됩니다: 여러 개의 얇은 레이어, 절대 하나의 회색 블러가 아닙니다. 높을수록 더 크고, 부드럽고, 희미해집니다.
  • 카드와 메뉴는 테두리 대신 그림자에 1px 링을 사용합니다. 솔리드 버튼은 희미한 내부 상단 하이라이트(--shadow-button)를 얻습니다.
  • 하나의 반경 패밀리. 반경은 높이에 따라 커집니다(컨트롤, 그다음 카드, 그다음 시트). 중첩된 모서리는 동심원입니다: 내부 반경 = 외부 반경 - 패딩 사이.
  • 다크 테마에서 깊이는 더 밝은 표면과 링에서 비롯되며 그림자에서 비롯되지 않습니다.
  • 제품당 하나의 깊이 기법(헤어라인, 소프트, 크리스프, 디퓨즈, 플랫 또는 립, 방향에 의해 설정). 글로우 없음, 모든 카드에 그림자 없음.
  • 블러와 반투명은 크롬에만 속합니다(고정 헤더, 시트, 시스템 재질), 콘텐츠 카드에는 절대 사용하지 않습니다.

세부 사항: references/premium-craft.md.

8. 컴포넌트

  • 모든 상호작용 요소는 상태를 가집니다: 기본, 호버, focus-visible, 눌림, 비활성화; 버튼의 로딩; 행과 토글의 선택됨. 호버가 유일한 단서가 되어서는 안 됩니다.
  • 버튼과 입력: 기본 40px, 컴팩트 32-36px, 터치 44-48px. 수평 패딩은 수직 패딩의 약 두 배. 레이블 = 동사 + 목적어("인보이스 생성"). 아이콘 전용 버튼에는 aria-label과 툴팁이 필요합니다.
  • 키보드 사용자를 위해 포커스 링이 항상 보여야 합니다: 2px --focus, 2px 오프셋. 대체 없이 outline: none을 사용하지 마세요.
  • 입력: 상단에 보이는 레이블(placeholder는 레이블이 아닙니다), --border-strong 가장자리, 하단 도우미 텍스트, 하단에 아이콘과 설명이 있는 오류. 긴 양식은 상단에 오류 요약을 추가합니다.
  • 양식의 주요 작업(저장, 계속)은 처음부터 보여야 합니다. 무언가 변경될 때까지 조용해 보일 수 있지만, 편집 후에만 나타나서는 안 됩니다.
  • 토글 스위치는 즉시 적용됩니다. 체크박스는 저장 시 적용됩니다.
  • 카드는 분리되고 비교 가능한 항목에만 사용합니다. 모든 섹션 주위에 사용하지 마세요. 카드 안에 카드를 절대 넣지 마세요.
  • 아이콘: 하나의 세트, 하나의 선 두께, 옆에 있는 텍스트 크기에 맞춥니다. 이모지를 아이콘으로 사용하지 마세요.
  • 이미지: 실제 콘텐츠, 고정 aspect-ratio, 의미 있는 alt, 1px 내부 아웃라인. 플레이스홀더 서비스는 사용하지 마세요. 아직 실제 사진이 없다면, 최종 크롭에 조용한 톤 블록과 작은 캡션("사진: 정원 방")을 사용하세요. 주제의 조잡한 그림을 사용하지 마세요. 주변의 모든 것을 싸구려로 만듭니다.
  • 모달은 짧고 집중된 작업에만 사용합니다. 인라인 편집 또는 사이드 패널을 선호하세요.
  • 파괴적 작업: 위험 색상, 이름 지정("프로젝트 삭제"), 확인 또는 실행 취소 가능. 빈번한 작업에는 확인보다 실행 취소가 더 좋습니다.

references/forms.md, references/tables-lists.md, references/navigation.md, references/dashboards-charts.md.

9. 피드백 상태

  • 100ms 이내에 모든 누름을 인지합니다. 약 300ms 후에만 스피너 또는 스켈레톤을 표시하고, 그런 다음 약 500ms 동안 유지합니다.
  • 스켈레톤은 알려진 레이아웃이 있는 페이지 또는 섹션 로드용입니다. 버튼과 작은 위젯 내부의 스피너; 약 10초 후 퍼센트가 있는 진행률 표시줄.
  • 비어 있음 상태 = 이것이 무엇인지 + 왜 비어 있는지 + 하나의 작업. 오류 = 무엇이 발생했는지 + 그것을 고치는 방법, 평범한 말로, 발생한 위치에서; 사용자의 입력을 절대 지우지 마세요.
  • 성공은 조용하고 구체적입니다("인보이스 1042가 Anna에게 14:02에 전송됨"). 토스트는 4-6초, 중요한 정보의 유일한 사본이 되어서는 안 됩니다.
  • 안전한 경우 낙관적으로 업데이트하고, 실패 시 실행 취소합니다. 속도는 품질로 읽힙니다.

세부 사항: references/feedback-states.md.

10. 감정과 신뢰

  • 사람들은 약 50ms 안에 화면의 룩을 판단하고, 그 룩은 신뢰성에 대한 첫 번째 테스트입니다. 구조는 단순하고, 익숙하며, 디테일에서 독특함이 승리합니다.
  • 사용자의 상태에 맞게 디자인하십시오: 불안함(다음에 무엇이 일어날지 말하고, 커밋 전에 요약을 제공하며, 쉽게 돌아올 수 있는 방법을 제공), 서두름(최소 단계, 미리 채워짐, 단축키), 회의적(주장 옆에 증거, 초기에 전체 가격), 전문가(밀도, 단축키, 확인 대신 실행 취소), 당황하거나 슬픔(중립적인 어조, 축하 없음).
  • 강하게 마무리하십시오: 마지막 단계와 확인은 사람들이 기억하는 것입니다.
  • 즐거움은 위험이 낮은 순간(첫 실행, 빈 상태, 성공)에 위치하며, 오류 또는 민감한 작업 중에는 절대 사용되지 않습니다. 어떤 일이 더 자주 발생할수록 더 평범합니다.
  • 다크 패턴을 거부하십시오: 가짜 긴급성이나 희소성, 가짜 리뷰, 미리 선택된 추가 사항, 숨겨진 비용, 취소하기 어려움, 확인 수치심 유발, 숨겨진 거부 옆에 큰 수락. 대신 정직한 버전을 제공하십시오.

세부 사항: references/psychology-emotion.md.

11. 플랫폼 규칙

  • 각 OS는 고유한 언어를 사용합니다. 그것을 배우고 존중하십시오. 크로스 플랫폼은 같은 화면이 어디에서나 동일하다는 것을 의미하지 않습니다. 각 플랫폼에서 기본적으로 지원하는 것을 사용자 지정보다 우선시하십시오.
  • 웹: 의미론적 HTML, 키보드 탐색, focus-visible, reduced-motion, prefers-color-scheme. 브라우저 기본 컨트롤(file input, select, calendar)은 스타일이 지정되거나 교체되어야 합니다. <select>는 아웃라인으로 유지됩니다.
  • macOS: 기본 제목 표시줄, 툴바, 사이드바, 시트, 팝오버. 시스템 글꼴(San Francisco, SF Mono), vibrancy 및 material. 창 그림자는 OS에서 제공합니다.
  • Windows: 제목 표시줄과 명령 모음. Segoe UI 변수, Fluent 디자인 언어. Mica 및 아크릴 배경.
  • iOS: 기본 내비게이션 바, 탭 바, 시트, 모달, 상황에 맞는 메뉴. SF 글꼴, 시스템 색상, 동적 유형 및 접근성 크기. macOS와 동일한 반경 팔레트이지만 화면 가장자리까지 닿습니다.
  • Android: Material Design 3, 상단 앱 바, 하단 내비게이션, 뱃지. Roboto 또는 Noto, Material You 동적 색상. 더 평평하고, 더 선명합니다.
  • Flutter: Material 3(MaterialAdaptive 포함 = 적응형) 또는 Cupertino를 대상 플랫폼에 따라. ThemeData를 ui-craft Studio의 theme.css와 일치시키거나 Material 3 ColorScheme.fromSeed로 악센트를 시드하십시오.
  • React Native: StyleSheet.create로 토큰, Platform.select로 적응. react-native-paper(Material), native-base, 또는 사용자 지정.
  • Electron: 웹 기술 + BrowserWindow 옵션으로 기본 OS와 일치시킵니다. 시스템 제목 표시줄을 선호하며, 필요할 때만 사용자 지정 제목 표시줄을 사용합니다.

세부 사항: references/platform-conventions.md.

12. 접근성

  • 키보드 전용으로 모든 것을 테스트하십시오.Tab으로 모든 대화형 요소에 도달할 수 있고, Enter/Space로 활성화되며, 포커스 순서가 의미가 있으며, 포커스가 항상 보여야 합니다.
  • 모든 이미지에는 alt 텍스트가 있어야 합니다. 장식 이미지에는 alt=""를 사용하고(화면 판독기에서 건너뜀), 정보 이미지에는 설명적인 alt를 사용하며, 아이콘에는 aria-label 또는 role="img"를 사용합니다.
  • 색상 대비는 §6을 따릅니다. 링크는 밑줄 또는 굵게 표시되어 텍스트와 구별됩니다(색상만으로는 안 됨).
  • 포커스 링은 §8을 따르며, 키보드 사용자가 어디에 있는지 보여주는 유일한 방법입니다.
  • 화면 판독기: <main>, <nav>, <aside>, <header>, <footer>, <article>과 같은 의미론적 랜드마크. <h1>-<h6> 헤딩은 콘텐츠 구조를 반영하며, 레이블링을 위해 aria-labelledby를 사용합니다. 동적 업데이트는 aria-live region에 있습니다.
  • 모션: prefers-reduced-motion: reduce를 존중합니다. 축소 시: 0ms 전환, 0px 패럴랙스, 페이드인 대신 즉시 표시, 애니메이션 없음.
  • 돋보기/확대: 200%까지 확대 시 콘텐츠가 잘리거나 겹치지 않습니다. 유동적인 레이아웃, 고정 너비 없음.
  • 음성 제어/스위치: 모든 대화형 요소에 충분한 크기(터치 타겟 44px 이상)와 레이블이 있습니다.
  • 접근성을 지름길처럼 다루십시오: 접근 가능한 디자인은 종종 더 나은 디자인입니다. 테스트는 보조 기술을 사용하여 수동으로 수행해야 하며, 자동화는 가장 명백한 것들만 포착합니다.

13. 터치 및 포인터 상호작용

속성마우스/키보드터치/스타일러스
타겟 크기 최소24x24px (권장 32x32px)44x44px (WCAG 2.2)
타겟 간 간격 최소4px8px
호버 상태필요 (데스크톱에서)필요 없음 (포인터가 없음)
active/pressed있음있음
포커스 링필요선택 사항 (터치 시 표시되지 않음)
툴팁호버 시 표시탭 시 표시 (길게 누름)
드래그예예 (스와이프/길게 누름)
  • 터치 타겟은 시각적 요소(예: 버튼 내부의 아이콘)보다 큽니다. ::before/::after로 확장하거나 패딩을 늘리십시오.
  • 스타일러스 입력은 마우스로 처리하지만 타겟은 44px여야 합니다.
  • iPad의 hover: hover 및 pointer: coarse 미디어 쿼리는 적응형 설계를 안내합니다.

14. ui-craft Studio

온라인 디자인 도구 https://najeebafridi.github.io/ui-craft/ 은 16가지 방향을 선택하고, 라이브 화면에서 편집하며, theme.css와 DESIGN.md를 내보낼 수 있습니다.

  • Studio를 사용하는 경우: "ui-craft를 사용해 생성된" 파일을 재정의하지 마십시오. Studio가 내보내는 파일은 항상 기본 테마 파일 역할을 합니다. 추가하거나 확장할 수 있지만 무시해서는 안 됩니다.
  • Studio를 사용하지 않는 경우: 첫 번째 설정을 수동으로 수행하십시오. node <skill-dir>/scripts/palette.mjs --accent "#HEX"는 OKLCH에서 전체 라이트 및 다크 팔레트를 생성합니다.

15. 참조 파일

이 스킬에는 references/ 디렉토리에 자세한 지침이 포함된 마크다운 파일이 포함되어 있습니다. 개별 파일을 열어 특정 주제에 대한 심층 설명을 확인하십시오.

  • references/color-theory.md - 색상 심리학 및 팔레트 구축
  • references/color-dark-mode.md - 다크 모드 관행
  • references/typography.md - 자세한 서체 규칙
  • references/layout-spacing.md - 그리드, 정렬 및 간격
  • references/premium-craft.md - 프리미엄 마무리 작업
  • references/forms.md - 양식 디자인 패턴
  • references/tables-lists.md - 테이블 및 목록 디자인
  • references/navigation.md - 내비게이션 패턴
  • references/dashboards-charts.md - 대시보드 및 차트
  • references/feedback-states.md - 로딩, 비어 있음, 오류, 성공
  • references/psychology-emotion.md - 사용자 심리학
  • references/platform-conventions.md - OS별 가이드라인
  • references/mockups.md - 빠른 클라이언트 목업
  • references/review-mode.md - 기존 제품 리뷰
  • references/review-checklist.md - 최종 점검 목록
  • references/directions.md - 미리 정의된 시각적 방향
  • references/mixing.md - 다른 장르/매체 차용

에셋:

  • assets/tokens.css - CSS 사용자 정의 속성으로 된 기본 디자인 토큰
  • assets/directions/ - 16가지 시각적 방향 각각에 대한 세부 사항이 포함된 디렉토리

스크립트:

  • scripts/palette.mjs - 악센트 색상에서 OKLCH 팔레트 생성
  • scripts/ui-audit.mjs - 페이지의 대비, 크기, 터치 타겟 등을 점수화

ui-craft 구축에 대한 자세한 내용은 references/ 하위 디렉토리의 파일을 참조하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬