Skip to content

feat : 프론트엔드 디자인 시스템 구축 및 데모 페이지 구현 #7

Merged
i3months merged 11 commits into
devfrom
feature/frontend-design-system-setting
May 11, 2026
Merged

feat : 프론트엔드 디자인 시스템 구축 및 데모 페이지 구현 #7
i3months merged 11 commits into
devfrom
feature/frontend-design-system-setting

Conversation

@Jaeho-Site

@Jaeho-Site Jaeho-Site commented May 9, 2026

Copy link
Copy Markdown
Contributor

변경 사항

구현

  1. Tailwind CSS v4 도입@tailwindcss/vite 플러그인 + @/* alias.
  2. 디자인 토큰 정의tokens.css@theme 블록을 SSOT 로:
    • Sage Scale 11단계 + Semantic Aliases 14개
    • Status (success/warning/danger/info × 3 shades)
    • Domain (직군 4 + 면접 유형 4, muted jewel tone)
    • Typography 3-Tier · 텍스트 스케일 10단계 (반응형 포함)
    • Radius / Shadow (sage-tint) / Motion / Z-Index 9단계 / Container max-width
  3. 글로벌 베이스global.css 에서 폰트 / focus-visible / prefers-reduced-motion 처리.
  4. docs/design-system.md 전면 재작성 — 12 섹션 (원칙 · 토큰 · 컴포넌트 인벤토리 · 4-State UI · 페이지 레이아웃 · 다크 모드 · 접근성 · 추가 절차).
  5. 데모 페이지frontend/src/pages/DesignSystem/ (15 파일, 섹션별 분리). App.tsx 는 thin wrapper.

토큰 → Tailwind 유틸리티 (예시)

  • bg-sage-500 · text-fg-muted · bg-primary
  • bg-success-50 text-success-700 · bg-job-frontend
  • text-display (size + lh + letter-spacing + weight 페어)
  • font-heading · rounded-pill · shadow-md · duration-normal · ease-standard
  • max-w-content (1280px) · z-[var(--z-modal)]

참고

  1. 데모 페이지는 나중에 없어질 페이지 -> 디자인 확인만 바람
  2. node 없다면 설치 권장, 있다면 .nvmrc에 명시해둔 버전 참고

확인 방법

cd frontend
npm install
npm run dev

http://localhost:5173 에서 9개 섹션 (Overview · Colors · Typography · Radius · Shadow · Spacing · Motion · Z-Index · Container) 확인.

  • npm run build 통과 — TS 타입 체크 + Vite 프로덕션 빌드 클린
  • 사이드바 네비게이션 정상 동작 (active 표시 · 앵커 스크롤)
  • Motion 섹션 hover 라이브 데모 동작 (200ms · ease-standard)
  • 모바일 (< lg) 에서 사이드바 숨김, 텍스트 스케일 반응형 (*-mobilelg:*)
image image image image

@i3months i3months requested review from csh1668, i3months and pswaao88 May 11, 2026 09:51
Comment thread docs/design-system.md
5. PR 시 스크린샷 첨부 (light/dark 양쪽)
- **2026-05** — Tailwind CSS v4 기반 **sage 모노크로매틱** 시스템으로 전면 개편. 이전 `Pretendard + 블루 브랜드` 스펙은 본 문서로 흡수.
- **2026-05** — Status / Domain 컬러를 muted jewel tone 으로 재정의 (Sage 톤과 조화).
- **2026-05** — Z-index, Container max-width, 4-State UI 패턴 등 누락 토큰 / 규약 보강.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

design-system.md에 프로젝트 디자인시스템 정리해둔거 좋네요.
프론트엔드 개발 시 저 부분 참고해서 디자인 일관성 유지하기도 좋아보입니다. 👍

</Sub>
</Section>
)
}

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

먼저 constant로 관련 디자인 컴포넌트 뽑아둔거 좋네요

@i3months i3months merged commit 67712ee into dev May 11, 2026
1 check passed
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.

2 participants