21 Grams UI은(는) 무엇을 하나요?
이미 존재하는 UI를 한 번 더 살펴보는 작업입니다. 21 Grams UI(21 Grams 패밀리의 UI 패키지)는 제품을 재설계하지 않으며 자체 UI 키트를 가져오지 않습니다. AI가 만든 UI의 특징을 제거하고 프로젝트가 이미 보유한 컴포넌트와 토큰을 통해 정해진 규칙 세트를 적용하여, 결과물이 신중하게 고려된 듯 보이고 빠르게 느껴지면서도 여전히 제품의 일부로 남도록 합니다.
규칙 0: 프로젝트 자체 컴포넌트 사용
모든 변경은 프로젝트가 이미 사용 중인 것을 통해 이루어집니다. 21 Grams UI는 병렬적인 컴포넌트 세트를 절대 구축하지 않습니다.
- 무엇이든 건드리기 전에 인벤토리를 작성하세요. 디자인 토큰이나 테마(CSS 변수, Tailwind 설정, 테마 파일), 컴포넌트 라이브러리(shadcn/ui, Radix, MUI, Chakra, 사내 키트, 클라이언트 디자인 시스템), 아이콘 세트, 차트 라이브러리, 애니메이션 라이브러리를 기록하세요. 각 공유 컴포넌트의 이름과 위치를 기록하세요.
- 있는 그대로 수정하세요. 버튼 규칙은 프로젝트의
Button(토큰, 변형, prop 또는 스타일)에 적용되어야 하며, 단일 화면에 일회성 복사본으로 적용되지 않아야 합니다. 색상이나 반경 규칙은 하드코딩된 값이 아닌 토큰에 적용되어야 합니다. - 해당 작업에 적합한 컴포넌트가 이미 있다면 새로 추가하지 말고, 21 Grams UI 효과를 위해 의존성(UI 키트, 아이콘 세트, 차트 또는 애니메이션 라이브러리)을 추가하지 마세요. 설치된 것을 사용하세요. 애니메이션 라이브러리가 없다면 CSS 전환을 사용하세요.
- 진정으로 누락된 부분(세그먼트 컨트롤, 스위치 등)이 있을 때는 프로젝트의 기존 프리미티브와 토큰으로 빌드하고, 프로젝트의 파일 레이아웃과 명명 규칙을 따르세요. 보고서에 그 사실을 명시하세요.
- 하우스 스타일 값은 차이를 메우기 위한 기본값일 뿐입니다.
rules/와tokens/tokens.css는 프로젝트가 결정하지 않은 부분에 대한 값을 제공합니다. 프로젝트의 토큰에 매핑하세요. 기존 시스템 옆에tokens.css를 붙여넣지 마세요. - 브랜드는 프로젝트의 것으로 유지됩니다. 브랜드 색상, 폰트, 로고, 아이콘 스타일, 음성은 절대 대체되지 않습니다. 21 Grams UI는 그것들이 어떻게 사용되는지(대비, 계층, 간격, 모션)를 변경할 뿐, 무엇인지는 변경하지 않습니다.
우선순위: 사용자의 말, 그다음 프로젝트의 디자인 시스템과 브랜드, 그다음 21 Grams UI 하우스 스타일입니다. 원칙, 해킹, 애니메이션 기법은 모든 곳에 적용되며, 프로젝트 자체 컴포넌트로 표현됩니다.
구성
- 하우스 스타일.
rules/에 8개 영역:radius.md(12/8/4 중첩),buttons.md(36px, .97 누름),motion.md(부드럽게, 트리거에서 시작, 바운스 없음),type.md(좁게, 적은 사이즈),spacing.md(4pt 그룹화),colour.md(하나의 악센트, AA),elevation.md(톤 채움),copy.md(간결하고 도움이 되게). 더불어 세 가지 컴포넌트 파일:icons.md(하나의 스타일, 라인, 솔리드 또는 듀오톤, 절대 혼용하지 않음),charts.md(라인, 컬럼 및 가로 막대),toggles.md(스위치와 세그먼트 컨트롤). 기본값은tokens/tokens.css에 있습니다. - 20가지 원칙. UX 및 애니메이션 원칙은
references/principles.md에 있습니다. - 10가지 디자인 해킹. CSS 레벨의 세부 사항은
references/design-hacks.md에 있습니다. - 20가지 애니메이션 기법. 구현 레벨의 모션 규칙(시작점, 지속 시간, 스태거, 누름, 드래그, 공유 레이아웃)은
references/animation-craft.md에 있습니다. - 10가지 타이포그래피 해킹. 예약된 굵기 너비, text-box trim, 밑줄 오프셋, 위첨자 간격, 유동 디스플레이 타입, 작은 대문자 약어, 둥근 따옴표, 중간 생략, 자동 하이픈, 줄 수 제한 제목이
references/typography.md에 있습니다. - 20가지 언슬롭(unslop) 규칙. 구성 및 콘텐츠 특징(필러 배지, 중복 레이블, 임의 이탤릭체, 장식용 모노, 추상 히어로 아트, 동일 가중치 기능, 모호한 헤드라인, 글로우, 광학 정렬, 로딩 상태)은
references/unslop.md에 있습니다.
데이터 시각화 스킬이 설치되어 있다면, 차트가 관련될 때마다 함께 로드하세요.
워크플로우
- 인벤토리 작성 (규칙 0). 프로젝트에 디자인 시스템이 전혀 없다면 그렇게 말하고 하우스 스타일 기본값을 사용하세요.
- 변경 전에 감사(audit)를 수행하세요. 화면이나 컴포넌트를 살펴보고 영역(반경 … 복사), 원칙 번호, 해킹 번호, 기법 번호별로 분류하여 결과를 목록화하세요.
references/principles.md,references/design-hacks.md,references/animation-craft.md,references/typography.md,references/unslop.md,rules/icons.md끝에 있는 체크리스트를 사용하세요. 각 결과에는 파일과 줄 번호, 무엇이 잘못되었는지, 수정 방법, 그리고 수정이 들어갈 기존 컴포넌트 또는 토큰이 명시되어야 합니다. 21 Grams UI 규칙이 프로젝트의 디자인 시스템과 충돌하는 모든 지점을 표시하여 사용자가 어떤 것을 우선할지 결정할 수 있게 하세요. - 감사 결과를 사용자에게 간략한 목록으로 보여주고 광범위한 변경을 적용하기 전에 물어보세요. 요청된 범위 내의 작고 명백한 수정은 바로 적용할 수 있습니다.
- 수정 사항을 다음 순서로 적용하세요: 토큰 → 공유 컴포넌트 → 화면. 감사된 범위 내에서 프로젝트 자체 규칙(포맷팅, 린트, 명명)에 따라 diff를 유지하세요.
- 브라우저에서 검증하세요. 변경된 각 화면의 전후 스크린샷을 촬영하세요. 호버, 누름, 포커스, 로딩, 오류, 두 테마, 축소 모션을 확인하세요. 버튼과 텍스트 대비를 측정하고 눈대중으로 하지 마세요. 모션의 경우 가능하면 전후를 녹화하세요. 드래그 가능한 구분선과 양쪽 모두에서 작동하는 상호작용이 있는 전후 페이지가 UI 개선을 검토하는 가장 명확한 방법입니다.
- 보고서에 영역, 원칙, 해킹, 기법별로 무엇이 변경되었는지, 어떤 컴포넌트와 토큰이 수정되었는지, 그리고 완료되지 않은 부분이 있는지 기록하세요.
하우스 스타일 개요 (차이를 메우기 위한 기본값)
- 반경: 컨테이너 12 / 컨트롤 8 / 작은 부품 4, 외부 - 패딩으로 중첩됩니다. 태그와 토글 외에는 알약(pill) 모양을 사용하지 않습니다.
- 버튼: 36px(컴팩트 32, 프로미넌트 40), 반경 8, 14/500, 하나의 솔리드 프라이머리, 뷰당 하나의 프라이머리, 호버는 색상 단계만, 누름은 색상 단계 +
scale(.97)150ms, 로딩 시 너비 유지. - 모션: 일상적인 UI에 바운스 없음. 메뉴는 트리거에서
scale(.95)로 220ms In / 175ms Out, 패널 240/190, 진입은 ease-out, 종료는 ease-in(진입의 ~80%), 목록 행은 30ms 스태거, 빈번한 상호작용은 즉시. - 타이포그래피: 프로젝트의 폰트(없으면 Geist). 모노는 코드 전용이며, 절대 레이블, 아이브로우, 배지, 타임스탬프, 숫자에 사용하지 않습니다(sans에서
tabular-nums로 숫자 정렬). 사이즈 12/14/16/22/28, 두께 400/500/600, 제목 -0.022em, 화면당 최대 4개 사이즈. 모바일에서는 제목이 한 단계 올라갑니다: 섹션 18, 카드 16. - 모바일 채팅 전송은
aria-label="Send"가 있는 아이콘 전용 44×44 종이비행기 버튼입니다. - 간격: 4pt 스케일. 그룹 내부가 그룹 간보다 더 좁습니다(4 / 6 / 16 / 24–32 / 48). 셀렉트 쉐브론은 오른쪽에서 12px, padding-right 36px.
- 색상: 하나의 악센트(동작, 포커스, 선택), 상태 색상은 별도, 버튼 텍스트 두 테마 모두에서 ≥ 4.5:1, 테마별
--on-accent사용. - 입체감: 기본 표면은 테두리나 그림자가 없는 채움 단계입니다. 떠 있는 레이어만 링과 그림자를 가집니다. 다크 모드는 레이어당 더 밝아집니다.
- 아이콘: 제품당 하나의 스타일(라인, 솔리드 또는 듀오톤)을 사용하고, 메뉴, 내비게이션, 툴바, 목록 또는 카드 내에서 절대 혼용하지 않습니다. 선택된 상태는 아이콘 스타일이 아닌 색상만 변경합니다. 하나의 아이콘 라이브러리, 하나의 선 두께, 그룹당 하나의 크기.
- 복사: 동사 + 목적어 버튼, 원인과 수정 방법을 포함한 오류 메시지, 문장 케이스, 이모지 없음, 과장된 단어 없음.
타협 불가 사항 (20가지 원칙 중)
- 사용자 트리거 UI 모션은 120-300ms이며, 종료는 진입의 약 80%입니다. 이동에
linear를 사용하지 마십시오. - 이징(easing)은 방향과 일치해야 합니다: 진입 ease-out, 종료 ease-in, 화면 내 A→B는 ease-in-out입니다. 일상적인 UI에서 오버슈트 없음.
- 고빈도 상호작용(키보드 내비게이션, 목록 하이라이트, 도구 내 탭)은 즉시 이루어집니다.
- 모든 입력은 100ms 이내에 인지되어야 합니다. 저장에는 낙관적 UI를 사용하세요. 400ms가 지나면 진행 상태를 표시하세요.
- 히트 영역은 터치에서 최소 44×44, 밀집 데스크톱에서 32×32여야 하며, 아이콘이 더 작더라도 마찬가지입니다.
- 뷰당 하나의 포커스와 하나의 기본 동작이 있어야 합니다. 어떤 것이 포커스를 잡으면 컨텍스트를 어둡게 하세요.
- 긴 숫자는 묶어서 표시합니다. 입력은 지저분한 형식을 허용하고 깨끗한 값을 다시 표시합니다.
- 특별한 이유가 없는 한 표준 배치와 아이콘을 사용하세요.
- 모든 컴포넌트 상태가 설계되어야 합니다: 유휴, 호버, 누름, 로딩, 성공, 오류, 비활성화.
prefers-reduced-motion: 움직임, 스케일 및 오버슈트를 제거하고, 간단한 불투명도 변경만 유지하세요.
타협 불가 사항 (10가지 해킹 중)
- 중첩 반경: 내부 = 외부 - 패딩.
- 테두리는 알파(
rgb(0 0 0 / .12))를 사용하고, 다양한 표면에 단색 회색 16진수를 사용하지 마십시오. - 팔레트와 그라데이션은 OKLCH(그라데이션에
in oklch)를 사용하세요. - 아이콘 선 두께는 인접한 텍스트의 굵기와 일치해야 합니다.
- 가로 스크롤러는 마스크로 가장자리를 희미하게 만듭니다.
- 아이콘 교체는
filter: blur(4px)로 크로스페이드합니다. - 다크 모드: 각 상위 레이어는 더 밝아집니다(페이지 < 카드 < 메뉴).
- 모바일 전체 높이:
dvh/svh를 사용하고, 맨100vh는 사용하지 마십시오. - 색상이 있는 카드 위의 흰색 배경 제품 사진:
mix-blend-mode: multiply.
타협 불가 사항 (10가지 타이포그래피 해킹 중)
- 호버 시 또는 선택 시 굵게 표시되는 것은 레이아웃을 절대 변경하지 않습니다(굵기 너비 예약).
- 버튼과 배지의 한 줄 레이블은 광학적으로 중앙에 정렬됩니다(
text-box-trim). - 링크 밑줄은 descender를 피합니다(
text-underline-offset: 0.2em). 위첨자는 줄 리듬을 깨지 않습니다. - 복사본에 실제 구두점 사용: 둥근 따옴표, 아포스트로피, en 대시,
…. - 끝 부분이 다른 이름은 중간이 생략됩니다. 그리드의 카드 제목은 동일한 줄 수로 고정됩니다.
타협 불가 사항 (20가지 애니메이션 기법 중)
- 팝오버와 메뉴는 트리거에서 자라납니다(
transform-origin은 트리거에),scale(.95)에서 시작하고 절대scale(0)이 아니며, 트리거로 다시 종료됩니다. - 이전 상태와 새 상태는 겹칩니다. 저장과 저장됨 사이에 빈 프레임이 있어서는 안 됩니다.
- 드래그는 포인터를 1:1로 추적하며, 잡고 있는 동안 전환 없이, 경계를 넘으면 고무줄처럼 늘어납니다.
- 카드 → 상세 화면은 동일한 요소를 확장합니다(공유
layoutId/ 뷰 전환), 분리된 대체가 아닙니다. - 세그먼트 컨트롤과 탭은 표시기와 함께 이동하는 마스크로 활성 레이블을 드러냅니다.
- 움직이는 손잡이는 약 12% 늘어납니다(면적 보존). 성공 시 한 번의 펄스가 있습니다.
제거해야 할 AI 특징
혼합된 아이콘 스타일(폴더 옆에 솔리드 하우스, 선택 시 솔리드로 바뀌는 아웃라인 아이콘), 한 화면에 두 개의 아이콘 라이브러리, 아이콘으로 사용된 이모지, 헤드라인 위의 "NEW" 필러 배지, 제목을 반복하는 아이브로우, 무작위 이탤릭체 또는 헤드라인의 모노 단어, 모노 레이블, 아이브로우, 배지, 타임스탬프 또는 숫자("// 01 STATUS"와 같은 대문자 모노), 실제 제품 대신 광택 있는 3D 오브, 동일한 기능 카드 행, "X, meet Y." 스타일 헤드라인, 빛나는 그라데이션 테두리, 인디고에서 바이올렛으로 가는 그라데이션, 그라데이션 텍스트, 색상이 있는 글로우 그림자, 모든 것에 동일한 16px 반경(내부 반경이 외부와 같음), 둥근 입력 옆에 있는 알약 버튼, 카드와 버튼의 호버 확대, 모든 것에 300ms ease-in-out, 페이지 로드 시 fade-up, 균일한 p-6 gap-6, 카드 안의 카드, 모든 블록에 그림자 + 테두리 + 반경, 모든 보조 텍스트에 회색-500, 제목의 이모지, 그리고 "Unlock", "Supercharge", "Seamless" 또는 "Oops!"와 같은 복사.
크레딧
원칙, 해킹 및 애니메이션 기법은 "20 Principles of UX & Animation", "10 Niche Design Hacks", "20 Ways to Make Beautiful AI Animations", "10 Niche Typography Hacks" 및 "20 Ways to Unslop AI Designs"라는 5개의 짧은 형식 디자인 비디오에서 의역 및 확장되었습니다. 크레딧은 README를 참조하세요.