Skip to content

docs(react): Pretendard 폰트 로드 정책 명시 및 가이드 추가 - #50

Merged
ndaemy merged 1 commit into
mainfrom
docs/font-loading-policy
May 7, 2026
Merged

docs(react): Pretendard 폰트 로드 정책 명시 및 가이드 추가#50
ndaemy merged 1 commit into
mainfrom
docs/font-loading-policy

Conversation

@ndaemy

@ndaemy ndaemy commented May 7, 2026

Copy link
Copy Markdown
Member

Summary

  • 패키지가 Pretendard 폰트를 자동 로드하지 않음을 README에 명시.
  • 호스트 앱이 직접 로드해야 하는 이유 + 세 가지 로드 방법 안내.
  • src/index.css의 Storybook-only entry 의도를 주석으로 명시.

Changes

  • packages/react/README.md: "## 사용법" 섹션 안에 "### 2. 폰트 설정 (Pretendard)" 추가. CSS @import / HTML <link> / npm self-host 세 가지 로드 방법 안내.
  • packages/react/src/index.css: 이 파일이 Storybook 전용 entry이며 publish 패키지에는 포함되지 않음을 주석으로 명시 (README와 cross-reference).

Decisions

호스트 앱 책임 패턴 (자동 번들 X)

대안:

  • (a) globalFontface + 풀 변수 폰트 → dynamic subsetting 손실, 한국어 폰트 다운로드 비용 ↑.
  • (b) Pretendard의 92개 subset @font-face 복제 → 유지보수 부담, Pretendard 제작자도 비권장.
  • (c) Pretendard 자체 호스팅 → 별도 PR 가치의 큰 변경.
  • (d) 호스트 앱 책임 + README 안내 ✅

(d)를 선택. 근거:

  • 조사한 5개 Panda 디자인시스템(Park UI, shadow-panda 등)과 주요 한국 디자인시스템(Wanted WDS, Goorm Vapor UI 등) 모두 (d) 패턴.
  • Goorm Vapor UI는 (a) → (d)로 명시적 마이그레이션한 PR #265 존재.
  • Pretendard 제작자(orioncactus, Wanted Lab)도 호스트 앱 로드 방식을 공식 권장.
  • dynamic subsetting 보존 + 중복 로드 회피 + 호스트 앱의 폰트 로드 전략 통제권 보존이 핵심 가치.

Testing

  • 코드 동작 변경 없음 (문서 + 주석만).
  • README 렌더링 GitHub 마크다운으로 확인 (PR diff 시각 검수).

@ndaemy
ndaemy merged commit 8dd606e into main May 7, 2026
1 check passed
@ndaemy
ndaemy deleted the docs/font-loading-policy branch May 7, 2026 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant