ui-craft은(는) 무엇을 하나요?
프리미엄해 보이고 사용하기 쉬운 인터페이스를 모든 플랫폼에서 구축하는 방법. 숫자는 CSS px 기준입니다. 네이티브 앱의 경우 px를 pt(iOS, macOS), dp(Android) 또는 epx(Windows)로 읽습니다.
프리미엄은 네 가지를 의미합니다. 적절함: 대상 사용자, 그들의 마음 상태, 그리고 플랫폼에 맞습니다. 결정됨: 작은 시스템(적은 수의 크기, 하나의 반경 패밀리, 하나의 악센트)이 모든 곳에 적용됩니다. 정교하게 제작됨: 디테일이 완성되었습니다. 정직함: 신뢰를 얻고 절대 속이지 않습니다. 올바르기만 한 화면은 평범해 보이고, 장식만 된 화면은 싸구려처럼 보입니다.
1. 워크플로우 (매번 이렇게 하세요)
- 만들기 전에 살펴보세요. 기존 디자인 시스템(토큰, 테마 파일, Tailwind 설정, 컴포넌트 라이브러리, 브랜드 색상, 폰트, 또는
DESIGN.md브리프와 ui-craft Studio에서 내보낸theme.css)이 있는지 확인하세요. 있다면 그것을 사용하고, 두 번째 시스템을 만들지 마세요. 빈 부분만 채우세요. - 사람을 이해하세요. 누가 이것을 사용하며, 어떤 마음 상태(서두름, 불안, 회의적, 흐름 속의 전문가)이고, 어떤 기분을 느껴야 합니까? 한 줄로.
references/psychology-emotion.md를 참조하세요. - 방향을 선택하세요. 정해진 정체성이 없다면,
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브리프를 내보내세요. - 코드 전에 디자인 브리프를 작성하세요. (답변이나 주석에):
제품: 소기업용 급여 관리 (웹 앱, 데스크톱 우선) 사용자와 느낌: 밤에 급여 처리를 하는 사업주, 실수에 대한 불안 -> 안전하고, 안내되며, 정확함 방향: 신뢰받는 장부; 악센트는 딥 틸(그들의 브랜드), 쿨한 중성색, 라이트 테마 서체: IBM Plex Sans + Mono, 14px 본문, 표 형식 숫자 형태와 깊이: 6px 반경, 부드러운 그림자 밀도와 모션: 컴팩트, 선명함 (120-200ms) 플랫폼: 반응형 웹 시그니처: 숫자가 장부처럼 설정됨; 확인은 정확한 금액과 시간을 명시함 이 화면의 주요 작업: 이번 달 실행을 검토하고 승인하기 - 먼저 구조를 만들고, 그다음 스타일을 적용하세요. 실제 콘텐츠로 레이아웃과 계층 구조를 만든 다음 시스템(토큰), 그다음 디테일을 만드세요. 로렘 입숨은 사용하지 마세요: 현실적인 이름, 숫자, 카피를 작성하세요. 시그니처를 일찍 구축하고 다른 모든 것은 그것보다 조용하게 유지하세요. 작동하는 모습을 보여주세요. 첫 번째 뷰는 사용 중인 화면입니다: 실제 데이터, 이미 선택된 합리적인 기본값, 주요 상호작용이 보입니다. 절대 모든 것이 비어 있거나 잠긴 상태, 죽은 "$0" 합계, 또는 이전 단계가 완료될 때까지 숨겨진 주요 단계에서 시작하지 마세요.
- 모든 상태를 디자인하세요: 로딩, 비어 있음, 오류, 성공, 긴 텍스트, 많은 항목, 하나의 항목, 권한 없음 (
references/feedback-states.md). - 마무리하고 확인하세요.
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 3ColorScheme.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-liveregion에 있습니다. - 모션:
prefers-reduced-motion: reduce를 존중합니다. 축소 시: 0ms 전환, 0px 패럴랙스, 페이드인 대신 즉시 표시, 애니메이션 없음. - 돋보기/확대: 200%까지 확대 시 콘텐츠가 잘리거나 겹치지 않습니다. 유동적인 레이아웃, 고정 너비 없음.
- 음성 제어/스위치: 모든 대화형 요소에 충분한 크기(터치 타겟 44px 이상)와 레이블이 있습니다.
- 접근성을 지름길처럼 다루십시오: 접근 가능한 디자인은 종종 더 나은 디자인입니다. 테스트는 보조 기술을 사용하여 수동으로 수행해야 하며, 자동화는 가장 명백한 것들만 포착합니다.
13. 터치 및 포인터 상호작용
| 속성 | 마우스/키보드 | 터치/스타일러스 |
|---|---|---|
| 타겟 크기 최소 | 24x24px (권장 32x32px) | 44x44px (WCAG 2.2) |
| 타겟 간 간격 최소 | 4px | 8px |
| 호버 상태 | 필요 (데스크톱에서) | 필요 없음 (포인터가 없음) |
| 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/ 하위 디렉토리의 파일을 참조하십시오.