Skip to content

[Setting/#141] 디자인 시스템 초기 세팅#142

Merged
jjjsun merged 4 commits into
developfrom
setting/#141
May 13, 2026
Merged

[Setting/#141] 디자인 시스템 초기 세팅#142
jjjsun merged 4 commits into
developfrom
setting/#141

Conversation

@jjjsun
Copy link
Copy Markdown
Contributor

@jjjsun jjjsun commented May 12, 2026

🔢 관련 이슈 링크

📌 변경사항PR

  • ✨Feature: 새로운 기능 추가
  • 🐞Bugfix: 버그/오류 수정
  • 📃Docs: 문서 수정(README 등)
  • 🔨Refactor: 코드 리팩토링 (기능 변경 없음)
  • 🧪Test: 테스트 코드 추가/수정
  • 🎨UI/UX: 디자인 및 사용성 수정
  • ⚙️Setting: 기본 세팅 작업

💻 작업내용

  • 디자인 시스템 컬러 토큰 구조 추가
  • typography 시스템 구조 추가
  • font family 및 text style 정의
  • radius 토큰 구조 추가
  • tailwind theme 토큰 연결
  • theme.css / typography.css 구조 분리

🪧 미완성 작업

N/A

🤔 논의 사항 및 참고 사항

font, color, rounded 설정 해두었으니 앞으로 개발할때는 정해진 팔레트에서만 사용하면됩니다!
추가로 필요한 디자인은 컴포넌트 개발 작업하면서 점차 늘려나갈 예정입니다!
기존의 global.css는 수정작업을 통해서 점차 줄여나갈 예정입니다.

✅ 체크리스트

  • 브랜치는 잘 맞게 올렸는지
  • 관련 이슈를 맞게 연결했는지
  • 로컬에서 정상 동작을 확있했는지
  • 충돌은 없는지
  • 불필요한 console.log 제거했는지

Summary by CodeRabbit

릴리스 노트

  • Style
    • 색상, 간격, 경계 반경을 위한 디자인 토큰 시스템이 추가되었습니다.
    • 다양한 텍스트 스타일과 타이포그래피 유틸리티 클래스가 추가되었습니다.

Review Change Stack

@jjjsun jjjsun requested a review from dew102938 May 12, 2026 05:03
@jjjsun jjjsun self-assigned this May 12, 2026
@jjjsun jjjsun added the ⚙️ Setting 기본 세팅 작업 label May 12, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 12, 2026

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

Project Deployment Actions Updated (UTC)
eatsfine Ready Ready Preview, Comment May 12, 2026 5:12am

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 12, 2026

📝 Walkthrough

Walkthrough

두 개의 신규 CSS 파일을 통해 프로젝트의 초기 디자인 시스템을 구축합니다. 색상 팔레트, 텍스트 역할, 타이포그래피 스케일, 그리고 경계 반지름을 설계 토큰으로 정의하여 일관된 스타일 기준을 제공합니다.

Changes

디자인 시스템 기초 설정

Layer / File(s) Summary
색상 및 간격 설계 토큰
src/styles/theme.css
:root에서 검정(3단계)/흰색(3단계)/금색(4단계) 팔레트, 텍스트 컬러 역할(주요/보조/음소거/플레이스홀더/비활성화/삼차), 경계 반지름(10/15/20px) 토큰 정의. @theme 블록에서 --color-*--radius-*로 네임스페이스화하여 재정의하며, --radius-30 추가 매핑 포함.
타이포그래피 시스템 및 유틸리티
src/styles/typography.css
Google Fonts 세 가지(영문 제목/영문 본문/한글) 임포트. :root에서 폰트 계열, 텍스트 크기(hero/heading1-3/body1-2/label/caption), 폰트 가중치(regular/medium/semibold/bold) 토큰 정의. @theme에서 재정의 후 @layer utilities에서 각 스케일의 유틸리티 클래스(.font-hero, .font-heading*, .font-body*, .font-label, .font-caption)를 제공하여 font-size, font-weight, line-height 일괄 설정 가능.

📋 검토 포인트

타이포그래피 토큰 살피기

src/styles/typography.css@theme 블록에서 한글 폰트가 --font-koerean으로 선언된 점 확인 (오타 가능성: "korean" 확인 권장)

색상 토큰 일관성

:root의 텍스트 컬러 역할(primary/secondary/tertiary/muted/placeholder/disabled)과 @theme--color-text-* 매핑이 모두 일치하는지 확인

경계 반지름 매핑

theme.css의 :root에는 10/15/20px만 정의되어 있으나, @theme에서 --radius-30이 추가로 매핑됨. 이 값의 출처 확인 필요 (정의되지 않은 변수 참조 가능성)

타이포그래피 유틸리티 호환성

.font-hero, .font-heading1 등의 클래스명이 프로젝트의 네이밍 규칙 및 기존 코드와 일치하는지 확인 권장

🎨 색상과 타입이 춤을 춘다네요 ✨
토큰으로 춤판을 짜니
디자인의 일관성도 따라오고
스타일 유지보수도 한결 편하네요!
아, 오타 하나 살짝 보이긴 하지만요 👀

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Linked Issues check ❓ Inconclusive PR에서 이슈 #141의 요구사항 중 블랙/화이트/골드 컬러와 텍스트 컬러 정의는 완료했으나, 폰트 및 폰트 스타일 정의는 체크리스트에 미완료로 표시되어 있습니다. 이슈 #141의 폰트 정의 항목이 미완료 상태인데, typography.css에서 이를 완료했는지 확인이 필요합니다. 완료했다면 이슈 체크리스트를 업데이트하면 좋을 것 같습니다.
✅ Passed checks (4 passed)
Check name Status Explanation
Out of Scope Changes check ✅ Passed 추가된 파일들(theme.css, typography.css)이 모두 이슈 #141의 디자인 시스템 및 토큰 구조 초기 세팅 범위 내에 있습니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed PR 제목은 '[Setting/#141] 디자인 시스템 초기 세팅'으로 변경사항의 핵심(디자인 시스템 구조 초기 구축)을 명확하게 반영하고 있습니다.
Description check ✅ Passed PR 설명이 저장소의 템플릿 구조를 잘 따르고 있으며, 관련 이슈 링크, 변경사항 분류, 상세한 작업내용, 논의사항, 체크리스트를 모두 포함하고 있습니다.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch setting/#141

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


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 and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

🧹 Nitpick comments (1)
src/styles/typography.css (1)

46-87: ⚖️ Poor tradeoff

유틸리티 클래스에서 CSS 변수를 활용하면 유지보수가 더 편할 거예요.

현재 .font-* 클래스들이 font-size, font-weight 값을 하드코딩하고 있어요. 위에서 정의한 CSS 변수들을 활용하면 나중에 디자인 토큰 값을 한 곳에서만 수정할 수 있어요.

예를 들어:

  • 48번 줄: font-size: 56px:root--text-hero: 56px와 중복
  • 49번 줄: font-weight: 700:root--font-weight-bold: 700과 중복

현재 방식도 동작하긴 하지만, 향후 디자인 시스템 확장을 고려하면 CSS 변수를 참조하는 게 더 나을 것 같아요.

♻️ 리팩터링 제안 (선택사항)
 `@layer` utilities {
   .font-hero {
-    font-size: 56px;
-    font-weight: 700;
+    font-size: var(--text-hero);
+    font-weight: var(--font-weight-bold);
     line-height: 140%;
   }
   .font-heading1 {
-    font-size: 40px;
-    font-weight: 700;
+    font-size: var(--text-heading1);
+    font-weight: var(--font-weight-bold);
     line-height: 130%;
   }
   .font-heading2 {
-    font-size: 32px;
-    font-weight: 600;
+    font-size: var(--text-heading2);
+    font-weight: var(--font-weight-semibold);
     line-height: 130%;
   }
   .font-heading3 {
-    font-size: 24px;
-    font-weight: 400;
+    font-size: var(--text-heading3);
+    font-weight: var(--font-weight-regular);
     line-height: 130%;
   }
   .font-body1 {
-    font-size: 22px;
-    font-weight: 400;
+    font-size: var(--text-body1);
+    font-weight: var(--font-weight-regular);
     line-height: 130%;
   }
   .font-body2 {
-    font-size: 18px;
-    font-weight: 400;
+    font-size: var(--text-body2);
+    font-weight: var(--font-weight-regular);
     line-height: 130%;
   }
   .font-label {
-    font-size: 14px;
-    font-weight: 500;
+    font-size: var(--text-label);
+    font-weight: var(--font-weight-medium);
     line-height: 140%;
   }
   .font-caption {
-    font-size: 12px;
-    font-weight: 400;
+    font-size: var(--text-caption);
+    font-weight: var(--font-weight-regular);
     line-height: 130%;
   }
 }
🤖 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 `@src/styles/typography.css` around lines 46 - 87, Replace hardcoded font
properties in the utility classes with the design-token CSS variables: for each
class (.font-hero, .font-heading1, .font-heading2, .font-heading3, .font-body1,
.font-body2, .font-label, .font-caption) swap font-size and font-weight values
to reference the corresponding :root variables (e.g., replace 56px with
var(--text-hero) and 700 with var(--font-weight-bold), and use appropriate
line-height variables like var(--line-height-xxx) if available); ensure every
occurrence of font-size and font-weight in those classes uses the token
variables so updates to :root propagate consistently.
🤖 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 `@src/styles/theme.css`:
- Around line 50-52: The `@theme` block is missing the --radius-15 token declared
in :root; add --radius-15: 15px inside the `@theme` block so that the CSS variable
(--radius-15) is consistent with :root and other tokens (references:
--radius-15, `@theme`, :root).
- Line 52: 현재 :root에 정의되지 않은 CSS 변수 --radius-30을 참조하고 있어 오류가 납니다; 수정하려면
src/styles/theme.css에서 해당 참조(--radius-30)를 찾아서 1) :root에 --radius-30: 30px; 같은
값을 추가하거나(필요한 경우), 또는 2) 해당 라인이 의도된 값이 --radius-15(또는 기존 정의된
--radius-10/--radius-20)이라면 참조를 그 변수명으로 바꿔 오타를 바로잡으세요; 관련 식별자: --radius-30,
--radius-15, --radius-10, --radius-20, :root.

In `@src/styles/typography.css`:
- Line 31: There's a typo in the CSS custom property name: replace the
misspelled --font-koerean with --font-korean so it matches the :root definition
and any references; update the variable declaration (currently "--font-koerean")
to "--font-korean" and verify any usages (e.g., var(--font-korean)) align with
the corrected name.
- Around line 29-44: The `@theme` block is missing the font weight tokens; add the
same variables defined in :root—--font-weight-bold, --font-weight-semibold,
--font-weight-medium, and --font-weight-regular—into the `@theme` declaration so
they are exposed to Tailwind, e.g. include those four --font-weight-* entries
alongside the existing --font-* and --text-* variables in the `@theme` block
(refer to the `@theme` block and the --font-weight-* variable names to locate
where to add them).

---

Nitpick comments:
In `@src/styles/typography.css`:
- Around line 46-87: Replace hardcoded font properties in the utility classes
with the design-token CSS variables: for each class (.font-hero, .font-heading1,
.font-heading2, .font-heading3, .font-body1, .font-body2, .font-label,
.font-caption) swap font-size and font-weight values to reference the
corresponding :root variables (e.g., replace 56px with var(--text-hero) and 700
with var(--font-weight-bold), and use appropriate line-height variables like
var(--line-height-xxx) if available); ensure every occurrence of font-size and
font-weight in those classes uses the token variables so updates to :root
propagate consistently.
🪄 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: CHILL

Plan: Pro

Run ID: a1261588-78e7-48ef-9d9d-5033b0266a5b

📥 Commits

Reviewing files that changed from the base of the PR and between 9b1fe28 and 29cfa11.

📒 Files selected for processing (2)
  • src/styles/theme.css
  • src/styles/typography.css

Comment thread src/styles/theme.css Outdated
Comment thread src/styles/theme.css Outdated
Comment thread src/styles/typography.css
Comment thread src/styles/typography.css Outdated
@jjjsun jjjsun changed the title [Setting/#141] [Setting/#141] 디자인 시스템 초기 세팅 May 12, 2026
Copy link
Copy Markdown
Contributor

@dew102938 dew102938 left a comment

Choose a reason for hiding this comment

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

확인했습니다 수고하셨어요!

@jjjsun jjjsun merged commit ebfb28b into develop May 13, 2026
4 checks passed
@jjjsun jjjsun deleted the setting/#141 branch May 13, 2026 02:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⚙️ Setting 기본 세팅 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

⚙️ [Setting] 디자인 시스템 및 디자인 토큰 구조 초기 세팅

2 participants