Tailwind CSS
옅은 설계선 위 큰 검은 제목과 하늘색 클래스, 비스듬한 앨범 미리보기의 청록·보라 대각선
Brand DNA
브랜드 DNA
- 브랜드명: Tailwind CSS(테일윈드 CSS). Tailwind Labs가 만드는 유틸리티 중심 CSS 프레임워크다.
- 한 줄 정체성: 작은 클래스들을 HTML 안에서 조합해 원하는 화면을 만든다. 미리 정해진 버튼 모양 하나를 강요하기보다, 색·간격·서체·상태를 다룰 재료를 제공한다.
- 공식 디자인 철학: 홈페이지는 HTML을 떠나지 않고 현대적인 웹사이트를 빠르게 만드는 일을 앞세운다. v4는 CSS 변수로 설정하는 방식, 자동 소스 탐색, 현대 CSS 기능을 중심으로 바뀌었다.
- 시그니처 요소 1개: 화면을 만드는 과정이 보이는 설계선. 큰 Inter 제목의 위아래에 가는 선과 고정폭 클래스 이름을 놓고, 어두운 코드 옆에 완성된 시각 결과물을 보여 준다. 하늘색 물결 마크와 코드의 cyan이 그 관계를 묶는다.
- 문서의 범위: 공식 프레임워크 기본값과 tailwindcss.com의 시각 문법을 함께 다룬다. 홈페이지 버튼을 프레임워크의 필수 버튼 규격으로 해석하지 않는다. ⑨의 상태 조합과 ⑫의 가상 앨범은 관찰을 바탕으로 만든 적용 예시다.
- 첫 공개와 현재 모습: v0.1.0은 2017년 11월 1일 공개됐다. 현재의 메이저 세대 v4.0은 2025년 1월 22일 발표됐고, 조사 시점 홈페이지 표시는 v4.3이다. v4.3 발표일은 2026년 5월 8일이다.
Tone & Mood
톤 & 무드
- 핵심 키워드 3개: 정밀함, 유연함, 실용적
- 무드 설명: 흰 종이 같은 넓은 면에 제목과 설계선을 놓는다. UI의 색은 거의 검정·회색이고, 하늘색은 클래스와 작은 링크에 집중한다. 생생한 색과 질감은 결과물 데모가 맡는다. 설명은 추상적인 찬사보다 실제 클래스 이름과 화면의 변화로 끝낸다.
- 비주얼 스타일: 모던 미니멀 — 얇은 경계, 낮은 채도의 바탕, 검은 제목. 코드와 결과물의 대비로 기능을 설명한다.
- 밀도(Density): Spacious — 홈페이지 제목이 96px까지 커지고, 데모 사이에도 넉넉한 여백이 있다. 문서 화면에서는 좌측 목차·본문·우측 목차가 같은 체계 안에서 밀도를 높인다.
- 모서리 성향: Soft — 코드 창과 작은 카드의 8~12px를 기준으로 분류했다. 주 버튼은 32px 알약, 결과물 프레임은 16px 이상도 쓴다. 프레임워크에는 0부터 완전 원형까지 모두 있다.
- 평면성: Subtle — 페이지 틀은 선으로 구분하고 미리보기·결과물에만 얕은 그림자를 둔다. 모든 구획을 떠 있는 카드로 만들지 않는다.
Color System
컬러 시스템 (CSS 변수)
공식 색 문서는 각 팔레트를 50~950의 11단계로 제공하고, OKLCH를 기본으로 설명한다. 아래 hex는 조사일 공식 사이트 배포 CSS에 들어 있는 sRGB 대체값이다. 광색역 원값과 색 공간이 다르므로 다른 버전의 hex 표와 섞지 않는다. 물결 마크의 #38BDF8은 다운로드 SVG 자체의 값이며, 현행 sky-400의 대체값 #00BCFE와 구분한다.
앨범은 cyan·purple·violet 팔레트로 만든 창작 커버다. 보라 끝색에는 현행 violet-600의 대체값 #7F22FE를 썼다. 이 커버의 배색은 공식 로고의 규정색과 별개다.
:root {
--font-text: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Arial, sans-serif;
--font-code: "IBM Plex Mono", Consolas, "Liberation Mono", monospace;
/* Primary — 공식 사이트의 sky 팔레트 */
--color-primary-50: #F0F9FF;
--color-primary-100: #DFF2FE;
--color-primary-200: #B8E6FE;
--color-primary-300: #77D4FF;
--color-primary-400: #00BCFE;
--color-primary-500: #00A5EF;
--color-primary-600: #0084CC;
--color-primary-700: #0069A4;
--color-primary-800: #005986;
--color-primary-900: #024A70;
--color-primary-950: #052F4A;
--color-logo: #38BDF8; /* 공식 SVG 물결, UI의 기본 sky와 별개 */
--color-secondary-500: #00B7D7; /* cyan-500, 데모의 보조색 */
/* Neutral — 공식 사이트의 gray 팔레트 */
--color-neutral-0: #FFFFFF;
--color-neutral-50: #F9FAFB;
--color-neutral-100: #F3F4F6;
--color-neutral-200: #E5E7EB;
--color-neutral-300: #D1D5DC;
--color-neutral-400: #99A1AF;
--color-neutral-500: #6A7282;
--color-neutral-600: #4A5565;
--color-neutral-700: #364153;
--color-neutral-800: #1E2939;
--color-neutral-900: #101828;
--color-neutral-950: #030712;
--color-neutral-1000: #000000;
/* 의미 역할은 적용 예시 (추정), 색 자체는 공식 팔레트 */
--color-success-bg: #ECFDF5; /* emerald-50 */
--color-success-fg: #007956; /* emerald-700 */
--color-warning-bg: #FFFBEB; /* amber-50 */
--color-warning-fg: #B75000; /* amber-700 */
--color-error-bg: #FEF2F2; /* red-50 */
--color-error-fg: #BF000F; /* red-700 */
--color-info-bg: #F0F9FF;
--color-info-fg: #0069A4;
--bg-base: #FFFFFF; /* 페이지 */
--bg-subtle: #F9FAFB; /* 데모 주위 */
--bg-elevated: #FFFFFF; /* 미리보기·입력 */
--bg-overlay: rgba(3, 7, 18, .4); /* 검색 딤: 적용 예시 (추정) */
--bg-code: #030712; /* 창 몸통 */
--bg-action: #000000; /* 홈페이지 Get started */
--bg-action-hover: #1E2939;
--bg-action-active: #101828; /* 눌림은 적용 예시 (추정) */
--fg-action: #FFFFFF;
--bg-danger: #BF000F; /* 위험 행동, red-700: 적용 예시 (추정) */
--fg-danger: #FFFFFF;
--text-primary: #030712;
--text-secondary: #4A5565;
--text-tertiary: #6A7282;
--text-disabled: #99A1AF;
--text-on-primary: #FFFFFF;
--text-link: #0069A4; /* 작은 링크: sky-700, 역할 배정 (추정) */
--text-utility: #0069A4;
--border-default: #E5E7EB;
--border-subtle: #F3F4F6;
--border-strong: #D1D5DC;
--border-focus: #0069A4; /* 적용 예시 (추정) */
--code-text: #E5E7EB;
--code-tag: #FB64B6; /* 공식 CSS의 pink-400 */
--code-value: #77D4FF;
--code-muted: #99A1AF;
}
- 라이트: 본문은 gray-950, 바탕은 흰색, 큰 행동은 검정이다. 하늘색을 넓은 버튼 면에 자동으로 쓰지 않는다. 축소한 데모의 작은 클래스 이름에는 sky-700을 골랐다. 흰 바탕 대비는 계산상 약 5.90:1이다.
- 다크: 공식 문서는
dark:변형을 지원한다. 사이트도light·dark·system상태를 처리하며, 다크에서 바탕은 gray-950·제목은 흰색·주 버튼은 gray-700으로 바뀐다. 이 문서의 어두운 판은 같은 구조의 별도 예시다. - 역할 매핑: emerald·amber·red는 공식 기본 팔레트의 이름이다. 이를 성공·주의·오류에 연결한 것은 이 문서의 제안이다(추정). Tailwind가 그 의미를 고정한 것은 아니다.
Typography
타이포그래피
- 폰트 페어링: 영문 UI는 Inter, 클래스·코드는 IBM Plex Mono다. 공식 사이트의 폰트 CSS에서 두 가족을 확인했다. 한글 전용 서체는 지정되어 있지 않으며, 한국어 적용에서는 Noto Sans KR 또는 시스템 한글 서체를 뒤에 두는 방법을 제안한다(추정).
- 서체 표기: Inter·IBM Plex Mono 모두 SIL OFL 1.1. 제작자 저장소에서 확인했다.
- 위계 (크기 / 굵기 / 행간 / 자간):
- Display: 96px / 400 / 96px / -4.8px — 홈페이지, 1280px 폭 실측. 휴대폰은 36px / 500 / 40px / -1.8px.
- H1: 60px / 400 / 60px / -3px — 공식 text-6xl·tracking-tighter 조합. 역할 배정은 적용 예시(추정).
- H2: 40px / 500 / 40px / -2px — 홈페이지 구획 제목 실측.
- H3: 24px / 500 / 32px / -.6px — text-2xl 크기, 역할 배정은 적용 예시(추정).
- Body Large: 18px / 500 / 28px / 0 — 홈페이지 소개 문장.
- Body: 16px / 400 / 24px / 0 — 기본값.
- Body Small: 14px / 400~600 / 24px / 0 — 메뉴와 버튼.
- Caption: 12px / 400 / 16px / 0 — 유틸리티 안내·보조 표기.
- 제목의 힘: 두꺼운 800 대신 큰 크기·짧은 행간·좁은 자간으로 만든다. 긴 문장은 왼쪽에 맞추고, 클래스 이름만 고정폭으로 바꾼다. 단순히 모든 텍스트를 mono로 만들지 않는다.
- 카드와 데모: 외부 글꼴 없이 Inter 이름과 시스템 대체 서체로 그린다. 글자 윤곽은 쓰지 않았다. 브라우저의 서체 대체에 따라 줄 길이는 조금 달라질 수 있다.
Spacing
스페이싱
- Base unit: 공식
--spacing: .25rem, 기본 글자 16px일 때 4px.p-6은 24px,gap-4는 16px이다.
:root {
--space-xs: 4px;
--space-sm: 8px;
--space-md: 16px;
--space-lg: 24px;
--space-xl: 32px;
--space-2xl: 48px;
--space-3xl: 64px;
--space-section: 80px; /* 20 단위, 예시의 구획 간격 */
}
- Container: 공식 홈페이지는 1280px 화면에서 좌우 약 40px를 설계 여백으로 둔다. 카드 안이나 상세 창에서는 그 고정 폭을 복사하지 않고 폭에 맞게 줄인다. ⑫는 좌우 32px, 640px 아래는 20px로 옮긴 적용 예시다(추정).
- 반응형: 프레임워크는 화면 폭 접두사를 쓴다. 이 데모의 두 열은 640px 아래에서만 쌓인다. 712px 상세 창에서는 제목과 주인공을 함께 보여 준다.
Border Radius
Border Radius
공식 기본 theme과 border-radius 문서의 값이다. rounded-lg는 8px, rounded-xl은 12px다. 버튼의 32px와 입력의 알약은 홈페이지에서 확인한 별도의 용도다.
:root {
--radius-none: 0;
--radius-xs: 2px;
--radius-sm: 4px;
--radius-md: 6px;
--radius-lg: 8px;
--radius-xl: 12px;
--radius-2xl: 16px;
--radius-3xl: 24px;
--radius-4xl: 32px;
--radius-full: 9999px;
}
Shadow / Elevation
Shadow / Elevation
프레임워크가 공개한 기본 그림자다. 페이지의 설계선에는 적용하지 않고 결과물·떠 있는 검색창 같은 곳에 골라 쓴다.
:root {
--shadow-none: none;
--shadow-xs: 0 1px 2px 0 rgba(0,0,0,.05);
--shadow-sm: 0 1px 3px 0 rgba(0,0,0,.1), 0 1px 2px -1px rgba(0,0,0,.1);
--shadow-md: 0 4px 6px -1px rgba(0,0,0,.1), 0 2px 4px -2px rgba(0,0,0,.1);
--shadow-lg: 0 10px 15px -3px rgba(0,0,0,.1), 0 4px 6px -4px rgba(0,0,0,.1);
--shadow-xl: 0 20px 25px -5px rgba(0,0,0,.1), 0 8px 10px -6px rgba(0,0,0,.1);
}
- xs~sm은 미리보기의 얇은 깊이, md는 떠 있는 결과 카드, lg~xl은 큰 패널에 쓰는 예시다(역할 배정은 추정). 다크에서는 진한 그림자만으로 면을 구분하기 어려워 가는 밝은 테를 함께 검토한다.
Iconography
Iconography
- 스타일: 홈페이지 검색은 16px 그리드의 채운 SVG 경로로, 돋보기의 테를 표현한다. 로고도 Filled다. 기능 데모의 작은 그림은 가는 윤곽선과 옅은 면을 함께 쓴다.
- Stroke 굵기: 검색 경로의 링 두께는 1.5px다. 이 문서에서 직접 그린 화살표·기능 아이콘은 24px 그리드·1.5px 선으로 맞췄다(적용 예시).
- 모서리 처리: 데모의 선 끝과 이음은 Round다. 작은 크기에서도 선이 뭉치지 않게 한다.
- 추천 라이브러리: Heroicons — 공식 사이트 푸터에서 안내하는 도구다. ⑫의 화살표·화면·달·조정 아이콘은 직접 그렸다.
- 로고: 공식 다운로드 SVG의 물결과 워드마크 경로를 그대로 사용했다. 워드마크는 UI 테마에 맞춰 밝고 어두운 색으로 표시한다.
Component Guide
컴포넌트 가이드 (상태별 CSS)
홈페이지 문법의 적용 예시다. 프레임워크 자체는 아래 버튼·폼·배지의 모양이나 의미를 강제하지 않는다. 주 버튼의 기본·호버는 사이트 클래스에서 확인했고, 나머지 상태 묶음은 같은 토큰으로 연결한 설계 제안이다(추정).
Button — 검은 알약, 흰 보조 단추, 글자형 단추. 각 변형에 공통 상태를 적용한다.
.tw-button { position:relative; display:inline-flex; align-items:center; justify-content:center; gap:var(--space-sm); min-height:40px; padding:8px 16px; border:1px solid transparent; border-radius:var(--radius-4xl); font:600 14px/22px var(--font-text); text-decoration:none; cursor:pointer; transition:background-color var(--duration-fast) var(--ease-out), color var(--duration-fast), border-color var(--duration-fast); }
.tw-button svg { width:16px; height:16px; flex:none; }
.tw-button--primary { background:var(--bg-action); color:var(--fg-action); }
.tw-button--primary:hover { background:var(--bg-action-hover); }
.tw-button--primary:active { background:var(--bg-action-active); }
.tw-button--secondary { background:var(--bg-elevated); color:var(--text-primary); border-color:var(--border-default); }
.tw-button--secondary:hover { background:var(--bg-subtle); border-color:var(--border-strong); }
.tw-button--secondary:active { background:var(--border-default); }
.tw-button--ghost { background:transparent; color:var(--text-secondary); }
.tw-button--ghost:hover { background:var(--bg-subtle); color:var(--text-primary); }
.tw-button--ghost:active { background:var(--border-default); }
.tw-button--danger { background:var(--bg-danger); color:var(--fg-danger); }
.tw-button--danger:hover { filter:brightness(.92); }
.tw-button--danger:active { filter:brightness(.82); }
.tw-button:focus-visible { outline:2px solid var(--border-focus); outline-offset:3px; }
.tw-button:disabled, .tw-button[aria-disabled="true"] { background:var(--border-subtle); color:var(--text-disabled); border-color:var(--border-default); cursor:not-allowed; filter:none; }
.tw-button[aria-busy="true"] { color:transparent; pointer-events:none; }
.tw-button[aria-busy="true"]::after { content:""; position:absolute; width:16px; height:16px; border:2px solid var(--text-disabled); border-top-color:var(--text-utility); border-radius:var(--radius-full); animation:tailwind-css-spin .8s linear infinite; }
@keyframes tailwind-css-spin { to { transform:rotate(360deg); } }
Input — Quick search처럼 흰 면과 가는 선을 쓰고, 포커스는 한 겹으로 표시한다.
.tw-input { width:100%; min-height:40px; padding:8px 16px; border:1px solid var(--border-default); border-radius:var(--radius-4xl); background:var(--bg-elevated); color:var(--text-primary); font:400 14px/22px var(--font-text); }
.tw-input::placeholder { color:var(--text-tertiary); }
.tw-input:focus { outline:2px solid var(--border-focus); outline-offset:2px; }
.tw-input[aria-invalid="true"] { border-color:var(--color-error-fg); }
.tw-input[aria-invalid="true"] + .tw-input-error { color:var(--color-error-fg); font-size:12px; margin-top:var(--space-sm); }
.tw-input:disabled { background:var(--bg-subtle); color:var(--text-disabled); cursor:not-allowed; }
Card — 넓은 그림이 담긴 데모 판. 제목과 설명은 그림 위에 둔다.
.tw-card { min-width:0; background:var(--bg-elevated); border:1px solid var(--border-default); border-radius:var(--radius-xl); overflow:hidden; }
.tw-card--raised { box-shadow:var(--shadow-md); }
.tw-card--strong { background:var(--bg-code); color:var(--code-text); border-color:var(--color-neutral-700); }
.tw-card--outlined { box-shadow:var(--shadow-none); }
.tw-card-title { font:500 20px/28px var(--font-text); letter-spacing:-.5px; }
.tw-code { margin:0; padding:var(--space-lg); border-radius:var(--radius-xl); background:var(--bg-code); color:var(--code-text); font:400 13px/1.9 var(--font-code); white-space:pre-wrap; overflow-wrap:anywhere; }
.tw-code .tag { color:var(--code-tag); }
.tw-code .value { color:var(--code-value); }
.tw-code .muted { color:var(--code-muted); }
Badge / Tag — 버전과 짧은 부가 설명. 프레임워크 이름만 보고 색 배지를 늘리지 않는다.
.tw-badge { display:inline-flex; align-items:center; padding:2px 8px; border-radius:var(--radius-full); font:500 12px/18px var(--font-text); }
.tw-badge--solid { background:var(--bg-action); color:var(--fg-action); }
.tw-badge--subtle { background:var(--bg-subtle); color:var(--text-secondary); }
.tw-badge--outline { border:1px solid var(--border-default); color:var(--text-secondary); }
.tw-utility { font:400 12px/18px var(--font-code); color:var(--text-utility); }
Navigation — 낮은 헤더, 왼쪽 로고와 버전, 오른쪽 문서·도구 링크.
.tw-nav { display:flex; min-height:56px; align-items:center; gap:var(--space-lg); padding:0 var(--space-lg); background:var(--bg-base); border-bottom:1px solid var(--border-subtle); }
.tw-nav-menu { margin-left:auto; display:flex; align-items:center; gap:var(--space-lg); }
.tw-nav-menu a { color:var(--text-primary); font:400 14px/24px var(--font-text); text-decoration:none; }
.tw-nav-menu a:hover { color:var(--text-link); }
.tw-nav-menu a[aria-current="page"] { color:var(--text-utility); }
공식 1단 메뉴는 Docs·Play·Blog·Showcase·Partners·Plus 순이다. 미리보기 안에서는 Docs·Play·Blog만 남겨 공간을 확보했다.
Motion
Motion
공식 기본 전환은 150ms, 기본 곡선은 cubic-bezier(.4,0,.2,1)이다. 홈페이지의 코드 타이핑·결과 변화는 기능을 보여 주는 데모다. 이 문서의 예시는 한 번에 읽히도록 정지 장면으로 만들었다.
:root {
--duration-fast: 150ms; /* 공식 기본 전환 */
--duration-base: 200ms; /* 예시에서 패널 변화에 배정 (추정) */
--duration-slow: 300ms; /* 예시에서 큰 전환에 배정 (추정) */
--ease-out: cubic-bezier(0,0,.2,1);
--ease-in-out: cubic-bezier(.4,0,.2,1);
}
@media (prefers-reduced-motion:reduce) {
.tw-button { transition:none; }
.tw-button[aria-busy="true"]::after { animation:none; }
}
Anti-patterns
Anti-patterns
1. 프레임워크의 모든 선택지를 홈페이지의 필수 디자인으로 해석하지 않는다. 색 팔레트가 있다고 화면을 색 견본판으로 만들지 않는다. 2. 큰 제목에 800~900 굵기와 넓은 자간을 동시에 주지 않는다. 홈페이지의 인상은 400~500 굵기, 좁은 자간, 큰 크기에서 나온다. 3. 코드의 모든 단어를 같은 cyan으로 칠하지 않는다. 태그·속성·값·보조 문자의 위계를 남긴다. 4. 기능 설명을 작은 컴포넌트 목록으로 채우지 않는다. 홈페이지처럼 코드와 하나의 완성된 결과물 사이의 관계를 보여 준다. 5. v3의 색 hex나 그림자 이름을 v4의 값처럼 섞어 쓰지 않는다. 버전과 색 공간을 확인하고, 라이트의 색을 다크에서 기계적으로 반전하지 않는다.
Sources
출처
- https://tailwindcss.com/
- https://tailwindcss.com/brand
- https://tailwindcss.com/docs/colors
- https://tailwindcss.com/docs/dark-mode
- https://tailwindcss.com/docs/theme
- https://tailwindcss.com/docs/border-radius
- https://tailwindcss.com/docs/box-shadow
- https://tailwindcss.com/_next/static/chunks/017r-ibrf-le-.css
- https://tailwindcss.com/_next/static/chunks/0n9_1tq74i09x.css
- https://tailwindcss.com/_next/static/media/tailwindcss-mark.0~s.iziag2xd..svg
- https://tailwindcss.com/_next/static/media/tailwindcss-logotype.0u85c.m~vu2nn.svg
- https://github.com/tailwindlabs/tailwindcss/releases/tag/v0.1.0
- https://tailwindcss.com/blog/tailwindcss-v4
- https://tailwindcss.com/blog/tailwindcss-v4-3
- https://raw.githubusercontent.com/rsms/inter/master/LICENSE.txt
- https://raw.githubusercontent.com/IBM/plex/master/LICENSE.txt
Tailwind CSS 이름과 로고는 각 권리자의 상표입니다.