# Font Awesome

> 웹에서 가장 유명하고 널리 사용되는 아이콘 라이브러리입니다. 무료 버전만으로도 2,000개 이상의 아이콘을 제공합니다.

- 층: 아카이브 (아이콘 패키지)
- ID: font-awesome
- 출처: 빌더스게이트 디자인 피팅룸 — https://ui.buildersgate.com/styles/font-awesome

## 정의

웹에서 가장 유명하고 널리 사용되는 아이콘 라이브러리입니다. 무료 버전만으로도 2,000개 이상의 아이콘을 제공합니다.

## 주요 특징

- 2,000개 이상의 무료 아이콘
- Solid, Regular, Brands 스타일
- Pro 버전은 16,000개 이상
- 오랜 역사와 커뮤니티
- CSS 또는 SVG 방식 지원

## 핵심 원칙

- npm install @fortawesome/react-fontawesome
- 번들 사이즈: 개별 아이콘 import
- 2,000+ 무료 아이콘

## 컬러 시스템

CSS font 기반 — color CSS property로 색상 제어. currentColor 지원

### 색상 역할

- icon-color: CSS color property — text-color와 동일하게

### 색상 제약

- Pro 아이콘 무단 사용 금지 — 라이선스 확인
- 아이콘 크기는 font-size로 제어 — width/height 무효

### 다크모드 전략

CSS color 변경으로 자동 처리

### 대비 요구사항

폰트 기반으로 텍스트 대비 규칙 동일 적용

## 타이포그래피

- 폰트 성격: 아이콘 패키지 — 타이포그래피 해당 없음. Font Awesome는 solid/regular/brands/light 등 다수 스타일
- 권장 폰트 수: 최대 0개
- 타입 스케일: 아이콘은 4px 배수 크기 권장 (16/20/24/32/40px)

### 타이포그래피 제약

- 아이콘 크기는 인접 텍스트 font-size의 1~1.5배 권장
- weight별 상이 stroke-width — 텍스트 굵기와 시각적 균형 맞추기

## 설계 제약

### 하면 안 되는 것

- 아이콘 스타일 혼용 금지 — 한 프로젝트에서 패키지 1~2개만
- 아이콘 단독 사용 금지 (레이블 없을 때) — aria-label 필수
- Font Awesome 아이콘을 지나치게 크게 사용 금지 — 범용 — 다양한 아이콘 수량 필요 시 최적화

### 반드시 포함할 것

- 일관된 크기 사용 (24px 기본 권장)
- 인터랙티브 아이콘에 tooltip 또는 레이블
- hover/active 상태 색상 피드백

### 모션 가이드

아이콘 자체 애니메이션 최소화. hover 시 opacity 변화 또는 scale 1.1 정도만.

## 사용 사례

- 브랜드 아이콘 필요 시 (Twitter, GitHub 등)
- 전통적인 웹 프로젝트
- Pro 아이콘 필요 시

## 추천 프로젝트 유형

- 브랜드 로고 아이콘 필요
- 전통적 웹 프로젝트
- Pro 아이콘 필요 시

## 장단점

### 장점

- 가장 많은 브랜드 로고 아이콘 포함
- 오랜 역사와 광범위한 레퍼런스
- Pro 버전 풍부한 아이콘

### 단점·한계

- 무료 버전 아이콘 스타일 제한
- Pro 버전 유료
- SVG 개별 import 설정 복잡

## 자주 묻는 질문

### Q1. Font Awesome이란 무엇인가요?

웹에서 가장 유명하고 널리 사용되는 아이콘 라이브러리입니다. 무료 버전만으로도 2,000개 이상의 아이콘을 제공합니다.

### Q2. Font Awesome의 핵심 디자인 원칙은 무엇인가요?

Font Awesome의 핵심 원칙은 npm install @fortawesome/react-fontawesome, 번들 사이즈: 개별 아이콘 import, 2,000+ 무료 아이콘입니다.

### Q3. Font Awesome은 어떤 프로젝트에 적합한가요?

Font Awesome은 브랜드 아이콘 필요 시 (Twitter, GitHub 등), 전통적인 웹 프로젝트, Pro 아이콘 필요 시, 브랜드 로고 아이콘 필요, 전통적 웹 프로젝트, Pro 아이콘 필요 시 등의 프로젝트에 적합합니다.

### Q4. Font Awesome의 장단점은 무엇인가요?

장점으로는 가장 많은 브랜드 로고 아이콘 포함, 오랜 역사와 광범위한 레퍼런스, Pro 버전 풍부한 아이콘이 있습니다. 단점으로는 무료 버전 아이콘 스타일 제한, Pro 버전 유료, SVG 개별 import 설정 복잡이 있습니다.

### Q5. Font Awesome에서 색상은 어떻게 사용하나요?

CSS font 기반 — color CSS property로 색상 제어. currentColor 지원 색상 역할은 icon-color: CSS color property — text-color와 동일하게입니다. 주의사항: Pro 아이콘 무단 사용 금지 — 라이선스 확인, 아이콘 크기는 font-size로 제어 — width/height 무효.

### Q6. Font Awesome에 어울리는 폰트 스타일은 무엇인가요?

Font Awesome에는 아이콘 패키지 — 타이포그래피 해당 없음. Font Awesome는 solid/regular/brands/light 등 다수 스타일 폰트가 적합합니다. 최대 0개 폰트 패밀리 사용을 권장합니다. 제약 사항: 아이콘 크기는 인접 텍스트 font-size의 1~1.5배 권장, weight별 상이 stroke-width — 텍스트 굵기와 시각적 균형 맞추기.

### Q7. Font Awesome 디자인에서 하면 안 되는 것은 무엇인가요?

Font Awesome에서 피해야 할 것: 아이콘 스타일 혼용 금지 — 한 프로젝트에서 패키지 1~2개만, 아이콘 단독 사용 금지 (레이블 없을 때) — aria-label 필수, Font Awesome 아이콘을 지나치게 크게 사용 금지 — 범용 — 다양한 아이콘 수량 필요 시 최적화.

## 참고 디자인 토큰

> 아래 토큰은 이 스타일의 참고 구현 예시다. 프로젝트의 브랜드 컬러·폰트에 맞게 조정하되, 위 컬러 시스템·타이포그래피·설계 제약은 지킨다.

### 색상

- primary: #339AF0
- secondary: #228BE6
- accent: #74C0FC
- background: #F8F9FA
- surface: #FFFFFF
- text: #212529
- textSecondary: #495057
- border: #DEE2E6

### 타이포그래피

- fontFamily: 'Font Awesome 6 Free', 'Noto Sans KR', system-ui, sans-serif
- headingWeight: 700
- bodyWeight: 400
- letterSpacing: 0

### 간격·반경·그림자·테두리

- spacing: unit 8px × scale 1
- borderRadius: sm 4px / md 8px / lg 12px / full 9999px
- shadow sm: 0 2px 4px rgba(0,0,0,0.08)
- shadow md: 0 4px 8px rgba(0,0,0,0.12)
- shadow lg: 0 8px 16px rgba(0,0,0,0.16)
- border: 2px solid #DEE2E6

### 컴포넌트 형태

- button: rounded / hover lift / text none
- card: elevated / hover lift
- input: outlined / focus ring
- badge: rounded / solid
- icon: lucide / stroke 2 / size 24px
- layout: boxed / section normal
- animation: 250ms ease

## 관련 링크

### 관련 스타일

- [React Icons](https://ui.buildersgate.com/styles/react-icons)
- [Bootstrap Icons](https://ui.buildersgate.com/styles/bootstrap-icons)
- [Material Icons](https://ui.buildersgate.com/styles/material-icons)

---

HTML 버전: https://ui.buildersgate.com/styles/font-awesome

이 문서는 https://ui.buildersgate.com/styles/font-awesome.md 로 제공됩니다. 전체 목록은 https://ui.buildersgate.com/llms.txt 를 참고하세요.