Skip to content

[ Refactor ] z-index 토큰 상수화 및 전역 일관성 적용 #98

Description

@hyun907

📝 리팩토링 설명

현재 프로젝트 전반에서 z-index 값이 각 컴포넌트 내부에서 개별적으로 하드코딩되어 사용되고 있음.

이로 인해 다음과 같은 문제가 발생하고 있음:

  • 동일한 레이어(모달, 툴팁, 오버레이 등)에 대해
    컴포넌트마다 서로 다른 z-index 값이 사용됨
  • 전역적인 레이어 우선순위를 한눈에 파악하기 어려움
  • 새로운 UI 추가 시 기존 컴포넌트의 z-index를 직접 확인·조정해야 함
  • 디자인 시스템에서 의도한 레이어 구조와 실제 구현 간 불일치 발생 가능

이에 따라 z-index디자인 시스템 기준의 상수(토큰)로 정의하고,
개별 컴포넌트에서는 해당 상수를 참조하도록 리팩토링이 필요함.

🌿 To-do

  • 디자인 시스템 기준 레이어 우선순위 정리
  • z-index 상수 정의 파일 생성 (예: shared/styles/zIndex.ts)
  • 기존 컴포넌트의 하드코딩된 z-index 제거
  • 모든 관련 스타일을 상수 기반으로 교체
  • 중복·불필요한 레이어 값 정리
  • 전역 적용 후 레이아웃/겹침 이슈 확인

📚 ETC

  • 대상 예시: Modal, Tooltip, BottomSheet, Toast, Onboarding Overlay 등
  • 관련 디자인 시스템 문서 (Figma 레이어 가이드) 참고

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions