Skip to content

[FIX] timo-web Pretendard 폰트 미적용 수정 - #93

Merged
kimminna merged 1 commit into
developfrom
fix/web/92-pretendard-font-not-applied
Jul 6, 2026
Merged

[FIX] timo-web Pretendard 폰트 미적용 수정#93
kimminna merged 1 commit into
developfrom
fix/web/92-pretendard-font-not-applied

Conversation

@kimminna

@kimminna kimminna commented Jul 6, 2026

Copy link
Copy Markdown
Member

ISSUE 🔗

close #92



What is this PR? 🔍

timo-web에서 Pretendard 폰트가 실제로 적용되지 않던 문제를 수정했습니다.

배경

  • 기존 구조: apps/timo-web/app/layout.tsx에서 next/font/localPretendardVariable.woff2를 로드해 --font-family-pretendard CSS 변수를 pretendard.variable 클래스명을 통해 <html>에 설정하고 있었습니다.
  • 발생 문제: 이 변수를 실제 텍스트에 연결하는 font-family 규칙이 timo-web 어디에도 없어, 변수만 정의된 채 소비되지 않고 브라우저 기본 sans-serif가 그대로 렌더링됐습니다.
  • 해결 방향: apps/timo-web/app/globals.css--font-family-pretendard 변수를 직접 소비하는 font-family 규칙을 추가해, 디자인 시스템 패키지의 스타일 export 구성과 무관하게 timo-web 자체에서 폰트가 적용되도록 했습니다.

폰트 적용

  • 변경 요약: apps/timo-web/app/globals.css@layer base* { font-family: var(--font-family-pretendard), sans-serif; } 규칙을 추가했습니다.
  • 이유: next/font가 --font-family-pretendard 변수 자체는 <html>에 세팅하지만, 이를 실제 요소에 적용하는 규칙이 timo-web에 없어 폰트가 무의미하게 정의만 되어 있었습니다.
  • 구현 방식: 전역 선택자(*)에 font-family를 지정해 모든 요소가 --font-family-pretendard 변수(존재하지 않으면 sans-serif로 폴백)를 상속받도록 했습니다.
  • 경계 · 제약: 디자인 시스템 패키지(@repo/timo-design-system)의 styles export가 실제 스타일 파일(globals.css)이 아닌 빈 components.css를 가리키고 있는 문제는 이번 PR 범위에서 제외했으며, 별도 이슈로 분리해 후속 작업으로 진행할 예정입니다.



To Reviewers

디자인 시스템 패키지의 styles export 자체를 고치는 대신 timo-web 쪽 globals.css에서 직접 font-family를 지정하는 방식을 택했습니다. 디자인 시스템 export 문제는 범위가 더 크고 다른 앱에도 영향을 줄 수 있어 별도 이슈로 분리했습니다. 이 접근이 임시방편으로 괜찮은지, 아니면 이번 PR에서 export 구조까지 같이 정리하는 게 나을지 의견 부탁드립니다.



Screenshot 📷



Test Checklist ✔

  • pnpm turbo run check-types --filter=timo-web 통과
  • pnpm turbo run lint --filter=timo-web — 미실행 확인: 기존 미커밋 design-system 파일의 import 순서 warning으로 실패했으며, 이번 PR 변경 파일(globals.css)과는 무관함
  • 브라우저에서 Pretendard 렌더링 육안 확인 — 미실행: dev 서버 미기동 상태에서 작업

- next/font로 설정된 --font-family-pretendard 변수를 실제로 소비하는 font-family 규칙을 globals.css에 추가했습니다
@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
timo Ready Ready Preview, Comment Jul 6, 2026 8:29am

@github-actions
github-actions Bot requested review from ehye1 and jjangminii July 6, 2026 08:29
@github-actions github-actions Bot added ⏰ Timo-web Timo 웹 서비스 🐛 Bug 기능이 정상적으로 작동하지 않는 문제 수정 ♦️ 민아 민아상 labels Jul 6, 2026
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

apps/timo-web/app/globals.css에 새로운 `@layerbase 블록을 추가하여, 전체 요소(\*)에 대해 font-family를 --font-family-pretendard 및 sans-serif로 지정했습니다. 기존 버튼 스타일 관련@layer` base 블록은 그대로 유지됩니다.

Changes

Pretendard 폰트 전역 적용

Layer / File(s) Summary
전역 font-family 규칙 추가
`apps/timo-web/app/globals.css`
새 `@layer base` 블록에서 `*` 선택자에 `font-family: var(--font-family-pretendard), sans-serif`를 지정해 전역 요소에 Pretendard 폰트가 실제로 적용되도록 함.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

  • Team-Timo/Timo-client#44: --font-family-pretendard 변수를 도입/바인딩한 작업으로, 본 PR에서 동일 변수를 소비하는 CSS 규칙과 직접 연결됨.

Suggested labels: `🛠️ Setup`

Suggested reviewers: `ehye1`

폰트 하나 고치는데 이렇게 정성이라니, Pretendard도 감동할 위트 넘치는 6줄짜리 수정이네요! 🎨✨ (참고: Tailwind CSS @layer 공식 문서)

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed 제목이 timo-web에서 Pretendard가 미적용되던 문제를 고치는 변경을 정확히 요약합니다.
Description check ✅ Passed 설명이 Pretendard 변수를 실제로 소비하도록 globals.css를 수정한 변경과 직접 맞닿아 있습니다.
Linked Issues check ✅ Passed 링크된 #92의 전역 Pretendard 적용 요구를 globals.css의 font-family 추가로 충족합니다.
Out of Scope Changes check ✅ Passed 변경은 globals.css의 전역 폰트 규칙 추가에 국한되어, 범위를 벗어난 수정은 보이지 않습니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/web/92-pretendard-font-not-applied

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/timo-web/app/globals.css`:
- Around line 5-9: The font-family rule is duplicated in both the app and
design-system global styles, which will create maintenance drift once the export
issue is fixed. Keep the `* { font-family: var(--font-family-pretendard),
sans-serif; }` rule as the single source of truth in
`apps/timo-web/app/globals.css`, and remove or deprecate the matching rule in
`packages/timo-design-system/src/styles/globals.css` once that stylesheet is no
longer needed. If the design-system rule must remain temporarily, add a clear
TODO/comment near the duplicate so it is easy to consolidate later.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: dca5d45b-3024-4bb7-b837-8b5d81d32a05

📥 Commits

Reviewing files that changed from the base of the PR and between 4ea48e3 and 317c4f7.

📒 Files selected for processing (1)
  • apps/timo-web/app/globals.css

Comment on lines +5 to +9
@layer base {
* {
font-family: var(--font-family-pretendard), sans-serif;
}
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Pretendard 변수 연결 확인 완료 — 폰트가 이제 실제로 적용됩니다 👍

layout.tsx에서 주입한 --font-family-pretendard 변수를 * 선택자로 소비하는 흐름이 정확합니다. PR 목표대로 폰트가 전역에 실제로 반영되는 구조입니다.

다만 참고로, packages/timo-design-system/src/styles/globals.css에 동일한 규칙(* { font-family: var(--font-family-pretendard), sans-serif; })이 이미 존재합니다. 지금은 디자인 시스템의 styles export 문제로 인해 의도적으로 중복 정의한 것으로 보이나, 해당 export 이슈가 해결되면 두 곳의 규칙이 중복되어 유지보수 부담이 생길 수 있습니다. 후속 작업 시 한쪽으로 통합하는 걸 권장드립니다. 관련 문서: MDN @layer

As per path instructions, docs/architecture/components.md에 명시된 대로 "This PR’s approach—app-wide global styling (via apps/timo-web/app/globals.css)... is consistent with treating fonts as an app-wide concern applied at the global layer" 이므로 이 위치에 규칙을 두는 것 자체는 적절합니다.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/timo-web/app/globals.css` around lines 5 - 9, The font-family rule is
duplicated in both the app and design-system global styles, which will create
maintenance drift once the export issue is fixed. Keep the `* { font-family:
var(--font-family-pretendard), sans-serif; }` rule as the single source of truth
in `apps/timo-web/app/globals.css`, and remove or deprecate the matching rule in
`packages/timo-design-system/src/styles/globals.css` once that stylesheet is no
longer needed. If the design-system rule must remain temporarily, add a clear
TODO/comment near the duplicate so it is easy to consolidate later.

Source: Path instructions

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

Timo Performance Report

Bundle Size — timo-web
라우트 크기 First Load JS
/ 0 B 🟡 205.50 kB
/focus 0 B 🟡 205.50 kB
/home 0 B 🟡 205.50 kB
/login 0 B 🟡 205.50 kB
/onboarding 0 B 🟡 205.50 kB
/settings 0 B 🟡 205.50 kB
/settings/account 0 B 🟡 205.50 kB
/settings/policy 0 B 🟡 205.50 kB
/statistics 0 B 🟡 205.50 kB
/today 0 B 🟡 205.50 kB

공유 번들: 205.50 kB
🟢 < 200kB  |  🟡 < 350kB  |  🔴 ≥ 350kB (First Load JS · gzip)

Lighthouse — timo-web

⚠️ Lighthouse 결과를 가져오지 못했습니다.

Image Optimization — timo-web

public/ 디렉토리에 이미지가 없습니다.

측정 커밋: 06ce578

@ehye1 ehye1 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

굿굿!!! 폰트가 적용이 되지 않고 있었구나...

@yumin-kim2 yumin-kim2 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

미적용을 발견하시다니 예리하십니다 🤟🤟

@kimminna
kimminna merged commit 1774226 into develop Jul 6, 2026
16 checks passed
@kimminna
kimminna deleted the fix/web/92-pretendard-font-not-applied branch July 6, 2026 08:38
@kimminna kimminna mentioned this pull request Jul 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⏰ Timo-web Timo 웹 서비스 ♦️ 민아 민아상 🐛 Bug 기능이 정상적으로 작동하지 않는 문제 수정

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FIX] timo-web Pretendard 폰트 미적용

3 participants