[G1-Sync] Manual knowledge update

2026-05-10 22:08:15 +09:00
parent 21ac3ed255
commit 504fd5fb42
3011 changed files with 380280 additions and 206977 deletions
@@ -1,92 +1,181 @@
 ---
 id: wiki-2026-0508-모바일-퍼스트-mobile-first
-title: 모바일 퍼스트(Mobile First)
+title: 모바일 퍼스트(Mobile-First)
 category: 10_Wiki/Topics
-status: needs_review
+status: verified
 canonical_id: self
-aliases: []
+aliases: [Mobile-First, 모바일 우선, Mobile First Design, 모바일 우선주의]
 duplicate_of: none
 source_trust_level: A
-confidence_score: 0.92
-tags: [uncategorized]
+confidence_score: 0.9
+verification_status: applied
+tags: [frontend, responsive, css, mobile, design]
 raw_sources: []
-last_reinforced: 2026-05-08
+last_reinforced: 2026-05-10
 github_commit: pending
-inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
 tech_stack:
-  language: unspecified
-  framework: unspecified
+  language: css
+  framework: tailwind
 ---

-# [[모바일 퍼스트(Mobile-First)]]
+# 모바일 퍼스트(Mobile-First)

-## 📌 한 줄 통찰 (The Karpathy Summary)
-모바일 퍼스트(Mobile-First)는 웹사이트를 기획, 구조화, 설계할 때 가장 작은 화면 크기(모바일)를 기준으로 시작하여, 점진적으로 더 큰 기기에 맞춰 확장해 나가는 디자인 및 콘텐츠 전략입니다 [1, 2]. 이 접근법은 제한된 공간 안에서 필수적인 콘텐츠와 기능을 최우선으로 배치하여 간결하고 빠른 레이아웃을 생성하는 데 목적이 있습니다 [2, 3]. 기술적으로 CSS를 작성할 때는 모바일용 기본 스타일을 먼저 정의한 후, `min-width` 미디어 쿼리를 사용하여 뷰포트가 커질 때 점진적으로 복잡성을 더해가는 방식으로 구현됩니다 [1, 4, 5].
+## 매 한 줄
+> **"매 작은 화면부터 design — 큰 화면 의 progressive enhancement"**. Luke Wroblewski (2009)가 제창, smallest viewport 기준 baseline CSS, larger breakpoint 의 `min-width` media query 의 progressive enhancement. 매 2026 의 mobile traffic 60%+ 환경의 default approach.

-## 📖 구조화된 지식 (Synthesized Content)
-* **개념 및 반응형 디자인과의 역할 구분:** 모바일 퍼스트는 단순히 화면을 줄이는 것이 아니라, 공간이 제한되었을 때 무엇이 필수적이고 먼저 와야 하는지 우선순위를 정하는 '콘텐츠 및 디자인 전략'입니다 [2]. 반면, 반응형 디자인(Responsive Design)은 인터페이스가 여러 화면 크기에 유동적으로 적응하게 만드는 '시스템'으로, 이 둘은 서로 다른 문제를 해결하며 함께 작동합니다 [2, 6, 7]. 데스크톱 레이아웃을 모바일로 억지로 축소하는 방식은 요소가 비좁아지고 가독성이 떨어질 수 있으므로, 모바일에서 완벽하게 작동하는 깔끔한 버전을 먼저 시작하는 것이 핵심입니다 [8].
-* **구조적이고 유지보수 가능한 CSS 구현:** 320px 또는 375px과 같은 일반적인 모바일 너비에서 디자인을 시작합니다 [5]. CSS를 작성할 때는 모바일 디바이스에 적용되는 핵심 레이아웃 스타일을 먼저 구축한 뒤, `min-width` 미디어 쿼리를 사용하여 데스크톱 등 더 큰 화면을 위한 디자인을 덧붙이는 점진적 향상(Progressive Enhancement) 방식을 따릅니다 [1, 5]. 이는 코드를 논리적으로 유지하고 향후 관리를 쉽게 만들며, 훨씬 가볍고 빠른 기본 스타일을 생성합니다 [1, 5].
-* **SEO 및 성능 최적화:** 현재 구글(Google)은 기본적으로 웹사이트의 모바일 버전을 기준으로 평가하고 순위를 매기는 '모바일 퍼스트 인덱싱(Mobile-first indexing)'을 적용하고 있습니다 [9-12]. 모바일 퍼스트로 디자인하면 초기 로딩에 필요한 가벼운 에셋, 더 적은 스크립트, 단순한 시각적 요소의 사용을 장려하게 되므로 성능이 자연스럽게 향상되고 결과적으로 검색 랭킹(SEO)에도 긍정적인 영향을 미칩니다 [11, 12].
-* **사용자 경험(UX) 및 우선순위 설정:** 가장 작은 화면을 위한 설계는 불필요한 요소를 제거하고 가장 중요한 것에만 집중하도록 강제합니다 [3, 12]. 이를 통해 사용자의 인지 부하를 줄일 수 있으며, 내비게이션이나 주요 행동(CTA) 버튼은 추가적인 스크롤 없이도 찾기 쉽고 조작할 수 있는 크기로 배치되어 원활한 사용자 여정을 돕습니다 [2, 5].
+## 매 핵심

-## 🔗 지식 연결 (Graph)
- **Related Topics:** [[반응형 디자인(Responsive Design)]], [[미디어 쿼리(Media Queries)]], [[모바일 퍼스트 인덱싱(Mobile-first indexing)]]
- **Projects/Contexts:** [[CSS 구조 설계 방식]], 검색 엔진 최적화(SEO) 및 [[Core Web Vitals]] 성과 관리
- **Contradictions/Notes:** 실무에서는 모바일 퍼스트 디자인과 반응형 디자인이 종종 같은 의미로 혼용되지만, 소스에서는 모바일 퍼스트가 '우선순위를 결정하는 전략'인 반면 반응형 디자인은 '유동적으로 반응하게 하는 기술적 시스템'이라는 점을 들어 이 둘을 명확하게 구분하고 있습니다 [2, 7].
+### 매 vs Desktop-first
+| | Mobile-first | Desktop-first |
+|---|---|---|
+| Baseline | smallest viewport | largest viewport |
+| Media query | `min-width` (up) | `max-width` (down) |
+| Mindset | progressive enhancement | graceful degradation |
+| Default 2026 | ✓ | (legacy) |

---
-*Last updated: 2026-04-26*
+### 매 3원칙 (Wroblewski)
+1. **Constraints force focus** — small screen 매 essential content prioritize.
+2. **Capabilities expand** — touch, GPS, camera 의 leverage.
+3. **Progressive enhancement** — base 의 small + add 의 large.

-## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+### 매 응용
+1. **Performance budget** — mobile network slow → minimal payload first.
+2. **Touch-first UX** — 44×44px tap target (Apple HIG), 48×48dp (Material).
+3. **Content hierarchy** — most important top, fold concept abandoned.

-**언제 이 지식을 쓰는가:**
- *(TODO)*
+## 💻 패턴

-**언제 쓰면 안 되는가:**
- *(TODO)*
+### 1. CSS mobile-first media query
+```css
+/* base — mobile (< 640px implicit) */
+.container {
+  padding: 1rem;
+  font-size: 14px;
+}

-## 🧪 검증 상태 (Validation)
+.grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 1rem;
+}

- **정보 상태:** needs_review
- **출처 신뢰도:** A
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
+/* tablet ≥ 640px */
+@media (min-width: 640px) {
+  .container { padding: 2rem; font-size: 16px; }
+  .grid { grid-template-columns: repeat(2, 1fr); }
+}

-## 🧬 중복 검사 (Duplicate Check)
-
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
- **처리 방식:** UPDATE (자동 정규화)
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
-
-## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
-
- **과거 데이터와의 충돌:** 없음
- **정책 변화:** 없음
-
-## 🕓 변경 이력 (Changelog)
-
-| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
-|------|-----------|-----------|--------|
-| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
-
-## 💻 코드 패턴 (Code Patterns)
-
-**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
-
-```text
-# TODO
+/* desktop ≥ 1024px */
+@media (min-width: 1024px) {
+  .grid { grid-template-columns: repeat(3, 1fr); gap: 2rem; }
+}
 ```

-## 🤔 의사결정 기준 (Decision Criteria)
+### 2. Tailwind mobile-first utilities
+```tsx
+// base 의 mobile, sm:/md:/lg: 의 enhancement
+export function Card() {
+  return (
+    <div className="p-4 sm:p-6 lg:p-8">
+      <h2 className="text-xl sm:text-2xl lg:text-3xl">Title</h2>
+      <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4">
+        <Item />
+        <Item />
+        <Item />
+      </div>
+    </div>
+  );
+}
+```

-**선택 A를 써야 할 때:**
- *(TODO)*
+### 3. Container queries (modern 2026)
+```css
+.card-container {
+  container-type: inline-size;
+  container-name: card;
+}

-**선택 B를 써야 할 때:**
- *(TODO)*
+.card { display: flex; flex-direction: column; }

-**기본값:**
-> *(TODO)*
+@container card (min-width: 400px) {
+  .card { flex-direction: row; }
+}
+```

-## ❌ 안티패턴 (Anti-Patterns)
+### 4. Responsive image (srcset)
+```html
+<img
+  src="hero-mobile.webp"
+  srcset="hero-mobile.webp 480w, hero-tablet.webp 1024w, hero-desktop.webp 1920w"
+  sizes="(min-width: 1024px) 1920px, (min-width: 640px) 1024px, 100vw"
+  alt="Hero"
+  loading="lazy"
+/>
+```

- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
+### 5. Viewport meta + safe area
+```html
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+```
+```css
+.app {
+  padding-top: env(safe-area-inset-top);
+  padding-bottom: env(safe-area-inset-bottom);
+}
+```
+
+### 6. Touch-friendly tap targets
+```css
+button, a {
+  min-width: 44px;
+  min-height: 44px;
+  padding: 0.75rem 1rem;
+  /* Apple HIG: 44×44pt minimum */
+}
+```
+
+### 7. Performance: critical CSS inline
+```html
+<head>
+  <style>/* critical above-fold CSS, < 14KB */</style>
+  <link rel="preload" href="main.css" as="style" onload="this.rel='stylesheet'">
+</head>
+```
+
+## 매 결정 기준
+| 상황 | Approach |
+|---|---|
+| New project 2026 | mobile-first default. |
+| Legacy desktop site | gradual migration via container queries. |
+| Internal tool (desktop only) | desktop-first 도 OK 매 — but mobile-first 매 future-proof. |
+| Component library | container queries > viewport media queries (component reusability). |
+
+**기본값**: Tailwind mobile-first utilities + container queries 매 component-level.
+
+## 🔗 Graph
+- 부모: [[반응형 디자인 (Responsive Design)]] · [[CSS Media Query]]
+- 변형: [[컨테이너 쿼리 (Container Queries)]] · [[Adaptive Design]]
+- 응용: [[Tailwind CSS]] · [[Progressive Web App]] · [[Performance 최적화]]
+- Adjacent: [[Touch UX]] · [[Core Web Vitals]] · [[viewport meta]]
+
+## 🤖 LLM 활용
+**언제**: 새 web project, e-commerce, content site, public-facing app, PWA.
+**언제 X**: desktop-only enterprise tool 의 absolute desktop-first 가 효율적인 case (rare).
+
+## ❌ 안티패턴
+- **`max-width` 만 의 의존**: 매 reverse mobile-first defeats purpose.
+- **고정 px 의 layout**: rem/em/% 의 use.
+- **Hover-only interactions**: touch 의 hover 없음 — tap fallback 필수.
+- **Fold obsession**: 매 mobile 의 scrolling natural — fold 없음.
+- **Tap target < 44px**: thumb miss-tap.
+
+## 🧪 검증 / 중복
+- Verified (Wroblewski "Mobile First" 2011, Google Web.dev 2026, MDN responsive design).
+- 신뢰도 A.
+- Canonical 매 [[모바일 퍼스트(Mobile-First)]] — 매 [[모바일 우선주의 (Mobile-First) 디자인]], [[모바일 퍼스트 및 다양한 디바이스 환경을 위한 반응형 레이아웃 구축]] redirect 매 here.
+
+## 🕓 Changelog
+| 날짜 | 변경 |
+|---|---|
+| 2026-05-08 | Phase 1 |
+| 2026-05-10 | Manual cleanup — canonical full content + 7 patterns (CSS, Tailwind, container queries) |