turtleneck은(는) 무엇을 하나요?
앱에 적합한 디자인을 선택하고, 규율을 가지고 빌드하세요. 모든 디자인은 프리셋(preset) 입니다: 하나의 공유 코어 위에 적용되는 변수 오버라이드 파일입니다. 기본 프리셋인 keynote 는 코어 자체입니다. 다른 모든 프리셋은 한 카테고리의 주요 사이트 5곳을 혼합한 것이며, 그중 하나를 단순히 복사한 것이 아닙니다.
이 스킬이 활성화되면, 충돌하는 경우 일반적인 "AI 기본값 회피" 스킬(예: frontend-design)을 재정의합니다. keynote에서는 시스템 폰트, 문장형 아이브로우(sentence-case eyebrows), 톤 변화 그라데이션 헤드라인이 올바른 기본값입니다.
이 파일과 함께 있는 파일들:
tokens.css: 코어 및 keynote 값입니다. 모든 색상은light-dark(light, dark)형식입니다;:root,.a-dark,.a-light또는data-theme의color-scheme이 절반을 선택합니다. 모든 프리셋 훅은:root에 나열되어 있습니다. 공유 컴포넌트(타입 스케일, 버튼, 타일,.a-grid,.a-rail,.a-stats,.a-reveal)도 여기에 있습니다.styles/<preset>.css: 변수 오버라이드와 몇 가지 프리셋 전용 규칙입니다.tokens.css다음에 로드됩니다.styles/<preset>.md: 프리셋당 한 페이지: 사용 시기, 토큰 표, 규칙, 컴포넌트 델타, 폰트, 피해야 할 사항, 체크리스트.recipes-html.md: 페이지 스켈레톤, 네비게이션, 히어로, 타일, 벤토, 갤러리, 비교, 푸터(휴대폰에서 아코디언), 리빌, 공유 프리셋 패턴(플립된 밴드, 검색 히어로, 레일, 스펙 테이블, 플랜 카드, 코드 프레임).tailwind.md,swiftui.md: 해당 스택을 위한 동일한 토큰.test-widths.html?src=<url>[&h=800][&full=1]: 320/375/414 너비를 나란히 표시하고 오버플로우 리포트를 제공합니다;full=1은 전체 페이지 휴대폰 스크린샷을 위해 각 프레임을 문서 높이까지 늘립니다.example.html및../../demos/(agent-skills 저장소 내): 완성된 페이지들.
0단계: 앱 유형 감지 (필수, 코드 작성 전)
- 기존 디자인 시스템 또는 명시적인 스타일 요청이 우선입니다. 프로젝트 토큰, 컴포넌트 라이브러리 테마, 브랜드 가이드 또는 "어둡고 빨갛게 만들어줘"와 같은 요청이 있다면 그것을 사용하고, 아래 핵심 규칙만 유지한 채 테이블은 건너뜁니다.
- 시그널을 읽으세요: 요청; README; 의존성 (
package.json,pyproject.toml,Podfile,Package.swift,Gemfile,*.csproj); 라우트; 기존 CSS; 제품 카테고리 및 대상 사용자. - 하나의 프리셋을 선택하세요:
| 카테고리 | 시그널 (요청, 제품, 의존성, 라우트) | 프리셋 |
|---|---|---|
| 프리미엄 하드웨어 | 물리적 제품, 소비자 기기, 라이프스타일 가젯, 런칭 페이지, "깔끔한", "미니멀", "프리미엄"; SwiftUI 마케팅 화면; 명확한 시그널 없음 | keynote |
| 비즈니스 소프트웨어 | 오피스/생산성, B2B, CRM/ERP, 인트라넷, IT/규정 준수, 헬스케어; 의존성 @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; 라우트 /admin, /settings, /reports | enterprise |
| 스트리밍 | 비디오, 영화/TV, 시리즈, 트레일러, 라이브 이벤트, VOD; 의존성 hls.js, video.js, shaka-player, @mux/*, react-player; 라우트 /watch, /browse, /title | cinema |
| 음악 & 소셜 | 음악/오디오, 플레이리스트, 크리에이터, 소셜 피드, 데이트, 피트니스 클래스, 청년 구독; 의존성 howler, tone, wavesurfer.js, expo-av; 라우트 /player, /playlist, /profile | vibe |
| 게이밍 하드웨어 | GPU/PC 부품, 콘솔, 주변기기, e스포츠, 벤치마크, 드라이버, "FPS"; 의존성 three, @react-three/fiber + 차트 라이브러리; 라우트 /specs, /compare, /drivers | power |
| 개발자 & 클라우드 | API, SDK, CLI, 호스팅, 배포, 데이터베이스, 관측 가능성, 결제 API, "개발자용"; 의존성 next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; 라우트 /docs, /changelog, /pricing | devtool |
| AI | 모델, 어시스턴트, 채팅, 에이전트, 제품이 "AI 기반"; 의존성 openai, @anthropic-ai/sdk, ai, langchain, transformers; 라우트 /chat, /research, /models | lab |
| 여행 | 숙박, 항공편, 라이드, 호텔, 예약, 여정; 날짜 선택기, 지도 (leaflet, mapbox-gl); 라우트 /search, /stays, /trips, /book | journey |
| 리테일 | 쇼핑, 스토어, 카탈로그, 마켓플레이스, 장바구니, 결제, 딜, 식료품, 패션; 의존성 @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js (제품 카탈로그 포함); 라우트 /shop, /products, /p/, /cart, /checkout, /category | market |
| 금융 | 은행, 신용카드, 결제, 지갑, 보험, 대출, 저축, 투자, 소비자용 계정 대시보드; 의존성 plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; 라우트 /accounts, /cards, /rates, /apply, /transfer (개발자에게 판매되는 결제 API는 devtool입니다) | vault |
| 자동차 | 자동차, 오토바이, 전기자전거, EV 충전, 모빌리티, 딜러, 시승; 컨피규레이터, 주행거리 및 사양 페이지; 라우트 /models, /configure, /inventory, /test-drive, /dealers | drive |
| 페이지 유형 | 프리셋 (동점자 해소) |
|---|---|
| 문서 사이트, 체인지로그 | devtool |
| 관리자 대시보드 | 비즈니스 사용자: enterprise; 개발자 대상: devtool |
| 쇼핑몰 | market; 단일 프리미엄 제품 페이지는 keynote |
| 포트폴리오 | 제품/디자인 작업: keynote; 영화, 사진, 모션: cinema |
| 모바일 앱 화면 | 네이티브 느낌의 유틸리티: keynote; 소비자 미디어 및 소셜: vibe |
| 게임 / 게임 스튜디오 | 경쟁 및 하드웨어적 성향: power; 스토리 중심, 트레일러: cinema |
| 다른 제품 내 AI 기능 | 해당 제품의 카테고리; AI가 제품 자체인 경우에만 lab |
| 다른 제품 내 예약 흐름 | 검색 및 결과 페이지에만 journey |
사용자 스타일 표현은 직접 매핑됩니다: "Apple 스타일 / 프리미엄 / 깔끔한" = keynote; "Microsoft / Fluent" = enterprise;
"Netflix 스타일" = cinema; "Spotify 스타일 / TikTok 스타일" = vibe; "게이밍 / NVIDIA 스타일" = power;
"Stripe / Vercel / GitHub 스타일" = devtool; "OpenAI / Anthropic 스타일" = lab; "Airbnb / Booking 스타일" = journey;
"Amazon / IKEA 스타일" = market; "뱅킹 / PayPal 스타일" = vault; "Tesla / BMW 스타일" = drive.
결과는 해당 회사 사이트가 아닌 카테고리 블렌드입니다 ("상표 및 자산" 참조).
- 약하거나 충돌하는 시그널:
keynote. - 빌드하기 전에 선택을 한 줄로 말하세요. 예: "Style: devtool (Next.js + Prisma, routes /docs and /pricing, sold to developers)." 그런 다음
styles/<preset>.md를 전체적으로 읽으세요 (keynote:styles/keynote.md).
프리셋이 변경할 수 있는 것
tokens.css (:root)의 변수와 몇 가지 자체 규칙을 통해서만 변경합니다:
- 폰트(디스플레이, 본문, 모노) 및 타입 스케일, 두께, 자간, 줄 높이;
- 아이브로우 및 인트로 스타일, 본문 크기(UI의 경우 14px 미만, 읽기 텍스트의 경우 16px 미만 절대 안 됨);
- 표면 및 텍스트 색상, 라이트/다크 기본값, 하나의 악센트 및 그 위의 텍스트, 링크 및 포커스 색상;
- 둥글기, 테두리, 그림자, 타일 채우기; 버튼 높이, 패딩, 두께, 대소문자;
- 내비게이션 높이, 채우기 및 흐림; 콘텐츠 너비, 섹션 및 타일 간격;
- 이징, 지속 시간, 리빌 거리, 호버 및 프레스 피드백;
- 이미지 및 카피 스타일 (해당 md 파일에서).
이 아래의 모든 내용은 모든 프리셋에 적용됩니다.
워크플로우
- 프로젝트를 존중하세요.
tokens.css+styles/<preset>.css를 로드하거나, Tailwind 테마를 병합하거나, SwiftUI 팔레트를 추가하세요. 프리셋은 해당 md 파일에 이름이 지정된 무료 폰트를 링크할 수 있습니다; 페이지는 여전히 폴백 스택에서 올바르게 보여야 합니다. 스타일링을 위해 npm 의존성을 추가하지 마세요. - 3줄로 페이지 계획을 작성하세요: 페이지가 판매하는 한 가지, 배경이 있는 섹션 순서, 한 가지 "순간" (플립된 챕터, 큰 통계 벤토, 데모, 비디오, 고정 스크롤).
- 먼저 카피를 작성하세요: 짧은 헤드라인(프리셋이 길이를 설정), 한 줄의 서브헤드라인, 인트로 최대 두 줄.
- 레시피를 사용하여 섹션별로 빌드하세요.
- 모든 테스트 너비에서 확인하세요 (반응형), 프리셋에 둘 다 있는 경우 라이트 및 다크 모드: 스크린샷, 오버플로우 체크, 체크리스트. 완료를 보고하기 전에 수정하세요.
핵심 규칙
타이포그래피
- UI용 패밀리 하나 (실제 코드, 키 및 API 값에만 모노 추가). 디스플레이 두께는 프리셋에서 가져옵니다.
- 크기가 커질수록 자간은 좁아집니다; 본문은 -0.022em 이상으로 음수 자간을 적용하지 않습니다.
- 디스플레이 크기는 유동적입니다
clamp(min, rem + vw, max); 항상 중간 항에 rem을 혼합하세요. - 읽기용 본문 16-17px; 조밀한 UI, 메타 줄 및 푸터에서만 14px. 본문 줄 높이 1.45-1.6.
- 헤드라인에
text-wrap: balance; 긴 단어는 줄바꿈됩니다 (overflow-wrap,hyphens). - 중요한 숫자는 크게 표시하고 표 형식 숫자를 사용합니다; 해당 레이블은 작게 표시합니다.
색상
- 브랜드 색상이 먼저입니다. 사용자 또는 프로젝트의 브랜드 색상이 프리셋 악센트를 대체하며, 프리셋 악센트는 폴백에 불과합니다. 프리셋은 여전히 레이아웃, 타입, 둥글기, 밀도, 이미지 및 모션을 결정합니다.
- 악센트 레시피 (브랜드 색상 또는 모든 악센트 변경),
:root에 한 번 설정:--a-blue: 채우기, 즉 주어진 브랜드 색상 (이전 이름 유지; "악센트"를 의미).--a-on-accent: 잉크 또는 흰색 중 채우기에서 4.5:1에 도달하는 쪽.--a-blue-hover: 한 단계 더 어둡게 (어두운 기본값에서는 더 밝게) 레이블이 여전히 통과하는 색상.--a-accent-text:light-dark(a, b), 각 테마에서--a-bg및--a-bg-alt에 대해 4.5:1에 도달할 때까지 밝기가 이동된 브랜드 색조. 링크, 악센트 아이브로우 및 포커스 링(>= 3:1)이 이를 읽습니다. 잉크 기본 버튼이 있는 프리셋(lab, journey)은--a-button-*에 잉크를 유지합니다; 브랜드는 여전히 여기에 위치합니다.
- 하나의 악센트, 작은 범위: 기본 CTA, 포커스, 링크, 로고 마크, 작은 배지 및 "추천" 마커. 프리셋이 명시하지 않는 한 큰 표면이나 본문 텍스트는 사용하지 않습니다. 상태 색상은 상태에만 사용합니다.
- 2-4단계의 중립 표면; 프리셋이 지정하는 대로 톤, 가는 선 또는 하나의 부드러운 그림자 수준으로 구분합니다.
- 텍스트는 흰색 위에 순수한 검정색이 아닙니다; 본문 회색은 AA 대비를 가진 실제 회색입니다.
- 모든 곳에서 AA: 텍스트와 해당 채우기의 버튼 레이블은 4.5:1, 큰 텍스트, 아이콘 및 의미를 전달하는 테두리는 3:1.
- 다크 모드는 반전된 팔레트가 아닌 다른 팔레트입니다: 올려진 표면은 한 톤 더 밝게, 깊이를 위한 그림자는 없습니다.
레이아웃 및 리듬
- 콘텐츠에는 너비 제한이 있습니다: 넓은 그리드(
--a-content-wide) 내부의 텍스트 열(--a-content), 유동적인 거터. - 섹션은 페이지 색상과 대체 색상을 번갈아 사용합니다; 타일은 해당 섹션의 반대 채우기를 사용합니다.
- 프리셋이 지정하는 경우 센터 히어로 및 섹션 오프너; 타일 내부의 텍스트와 긴 카피는 왼쪽 정렬됩니다.
- 페이지당 한 가지 순간; 프리셋이 밴드 위에 구축되지 않은 경우 최대 한 개의 플립된(어둡거나 밝은) 챕터.
반응형 (엄격한 규칙: 모든 해상도, 모든 프리셋)
- clamp 토큰의 유동적인 타입 및 간격; 375px에서 작은 값, 1440px에서 큰 값.
- 깨질 수 있는 고정 너비 또는 높이 없음:
max-width+ 거터,min(),minmax(0, 1fr),aspect-ratio,min-height. 절대100vh(svh/dvh사용). 텍스트를 포함하는 Flex/그리드 자식은min-width: 0을 받습니다. - 그리드는 공간에 따라 재배치됩니다: 기기 중단점이 아닌
repeat(auto-fit, minmax(min(100%, 20rem), 1fr)). - 미디어 스케일:
max-width: 100%; height: auto; SVG는viewBox를 유지합니다. - 내비게이션: 834px 미만(또는 6개 이상의 링크가 맞지 않는 즉시: 컨테이너 쿼리)에서 텍스트 링크는 전체 화면 메뉴(네이티브
popover, JS 없음)로 이동합니다; 기본 링크 스타일보다 우선하는 규칙으로<li>를 숨깁니다(레시피: 글로벌 내비). 마크, 검색 및 하나의 액션을 보이게 유지합니다. 텍스트 링크 없음(검색, 계정, 장바구니만): 햄버거 메뉴 없음. - 모든 너비에서 가로 스크롤바 없음; 의도적인 스크롤러(갤러리, 레일, 코드)만 자체 상자 내에서 오버플로우됩니다.
- 터치 대상 >= 44x44px: 작은 알약, 견본, 패들, 내비게이션 링크는 보이지 않는 히트 영역(
.a-hit)을 얻습니다. - 안전 영역:
viewport-fit=cover; 거터 및 하단 패딩은env(safe-area-inset-*)를 사용합니다. - 매우 큰 화면: 유형과 콘텐츠는 제한에서 멈춥니다; 배경은 전체 너비로 유지됩니다.
- 휴대폰 가로 모드: 히어로는 뷰포트 높이가 필요하지 않아야 합니다; 고정된 요소는 1/3 이상을 덮지 않습니다.
- 줌 200%: 절반 너비의 뷰포트와 동일; 모든 것이 재배치되고 잘리는 부분이 없습니다.
완료라고 말하기 전에 테스트 너비를 확인하세요 (브라우저 창: 각각 resize_window, 스크린샷, 추가로 document.documentElement.scrollWidth === innerWidth 및 뷰포트보다 넓은 요소 목록):
| 너비 | 의미 |
|---|---|
| 320 | 작은 휴대폰, 640의 200% 줌 |
| 375 / 414 | 표준 / 대형 휴대폰 |
| 768 / 1024 | 태블릿 세로 / 가로, 작은 노트북 |
| 1280 / 1440 | 노트북 / 데스크탑 (참조 너비) |
| 1920 / 2560 | 풀 HD / QHD, 울트라와이드 |
| 812x375 | 휴대폰 가로 모드 |
| 640 | 200% 줌에서 1280px |
너비당 보고: 스크린샷 촬영, 오버플로우 예/아니오, 수정 사항. Headless Chrome은 500px 미만의 창을 제한합니다; 브라우저 창에서 또는 test-widths.html?src=<page url>(동일한 http 루트)로 휴대폰 너비를 테스트하세요.
Headless 캡처: <html>에 data-theme="light|dark"로 테마를 강제 적용합니다; 리빌 콘텐츠는 정적 캡처에서 보이지 않으므로 --virtual-time-budget=5000을 전달하거나 <html>에 data-reveal="off"를 설정합니다; 100svh 히어로는 긴 전체 페이지 창에서 늘어나므로 캡처를 위해 고정(min-height: 800px)합니다 (&full=1이 둘 다 수행합니다).
컴포넌트
- 버튼: 최소 높이 44px (더 작은 시각적 요소는 히트 영역을 얻음), 프리셋이 대문자를 지정하지 않는 한 문장형, 뒤에 오는 쉐브론 또는 화살표를 제외한 아이콘 없음, 그라데이션 없음. 기본 채우기, 보조는 프리셋에 따름.
- 링크: 시각적으로 링크(색상 또는 밑줄); 프리셋이 사용하는 경우 "Learn more ›" 스타일 쉐브론.
- 타일/카드: 전체 타일이 링크될 때 하나의 탭 정지점(내부 버튼은
span). 둥글기, 채우기, 테두리 및 그림자는 프리셋에서 가져옴; 채우기 + 테두리 + 그림자를 동시에 사용하지 않음. - 포커스 링: 모든 상호작용 요소에 2px 실선
--a-focus, 오프셋 1px. - 내비게이션: 프리셋에 따라 솔리드 또는 글라스, 최대 하나의 막대 고정, 현재 페이지 표시.
- 푸터: 조용함: 열에 작은 회색 링크, 법적 행; 열은 휴대폰에서
<details>아코디언이 됨.
이미지
- 실제 주제: 제품, 해당 UI, 사용자 자신의 사진 및 미디어. 크고 의도적으로 자릅니다.
- 노트북을 사용하는 스톡 인물, 3D 블롭, 이모지, 마스코트, 모든 헤딩 앞의 아이콘 없음.
- 자산 없음: 주제를 CSS 변수로 색상이 변경된 SVG
<symbol>로 한 번 그리거나, 올바른 비율의 정직한 회색 플레이스홀더를 사용합니다.
모션
- Transition named pr
…
[번역을 위해 잘림]