hgzero/design/uiux/style-guide.md

회의록 서비스 스타일 가이드

1. 디자인 철학

핵심 원칙

• Mobile First: 모바일 환경 우선 설계
• 깔끔한 미니멀리즘: 정보의 명확한 계층 구조와 여백 활용
• 직관적 UX: 사용자가 생각 없이 사용 가능한 인터페이스
• 일관성: 모든 화면에서 동일한 디자인 패턴 적용

---

2. 컬러 시스템

Primary Colors (주요 색상)

--primary: #4DD5A7;           /* 민트 그린 - 메인 액션, CTA */
--primary-dark: #3DBD95;      /* 민트 그린 (진하게) - 호버, 액티브 */
--primary-light: #E8F9F3;     /* 민트 그린 (연하게) - 배경, 하이라이트 */

Semantic Colors (의미 색상)

--success: #4DD5A7;           /* 성공, 완료 */
--warning: #FFB74D;           /* 경고, 임박 */
--error: #FF6B6B;             /* 에러, 긴급 */
--info: #64B5F6;              /* 정보, 알림 */
--ongoing: #FF9800;           /* 진행 중 (주황) */

Neutral Colors (중립 색상)

--gray-900: #212121;          /* 제목, 강조 텍스트 */
--gray-700: #616161;          /* 본문 텍스트 */
--gray-500: #9E9E9E;          /* 보조 텍스트 */
--gray-300: #E0E0E0;          /* 구분선, 테두리 */
--gray-100: #F5F5F5;          /* 배경 (연한 회색) */
--white: #FFFFFF;             /* 카드, 모달 배경 */

색상 사용 가이드

• Primary: 주요 액션 버튼, 활성 탭, FAB
• Success: 완료 상태, 체크박스 체크됨
• Warning: 마감 임박 Todo, 경고 배지
• Error: 에러 메시지, 마감 지연 Todo
• Gray: 텍스트, 구분선, 비활성 요소

---

3. 타이포그래피

폰트 패밀리

--font-family: -apple-system, BlinkMacSystemFont, "Segoe UI",
               "Noto Sans KR", "Roboto", sans-serif;

폰트 크기 (Mobile First)

/* Mobile (320px~768px) */
--font-h1: 24px;              /* 페이지 제목 */
--font-h2: 20px;              /* 섹션 제목 */
--font-h3: 18px;              /* 서브 타이틀 */
--font-body: 16px;            /* 본문 */
--font-small: 14px;           /* 보조 정보 */
--font-caption: 12px;         /* 캡션, 메타 정보 */

/* Tablet/Desktop (768px+) */
--font-h1-desktop: 32px;
--font-h2-desktop: 24px;
--font-h3-desktop: 20px;
--font-body-desktop: 16px;

폰트 굵기

--font-weight-regular: 400;
--font-weight-medium: 500;
--font-weight-bold: 700;

사용 예시

• 제목 (H1): font-size: 24px, font-weight: 700, color: --gray-900
• 본문 (Body): font-size: 16px, font-weight: 400, color: --gray-700, line-height: 1.6
• 보조 정보 (Small): font-size: 14px, font-weight: 400, color: --gray-500

---

4. 간격 시스템 (Spacing)

기본 단위 (8px 그리드 시스템)

--space-xs: 4px;
--space-sm: 8px;
--space-md: 16px;
--space-lg: 24px;
--space-xl: 32px;
--space-xxl: 48px;

사용 가이드

• 컴포넌트 내부 패딩: 16px (--space-md)
• 카드 간격: 16px (--space-md)
• 섹션 간격: 24px (--space-lg)
• 페이지 여백: 16px (Mobile), 24px (Tablet/Desktop)

---

5. 레이아웃 & 그리드

브레이크포인트

--breakpoint-mobile: 320px;
--breakpoint-tablet: 768px;
--breakpoint-desktop: 1024px;

컨테이너 Max-Width

--container-mobile: 100%;
--container-tablet: 768px;
--container-desktop: 1200px;

그리드 시스템

• Mobile: 4 columns (16px gutter)
• Tablet: 8 columns (16px gutter)
• Desktop: 12 columns (24px gutter)

---

6. 카드 디자인

카드 스타일

.card {
  background: var(--white);
  border-radius: 12px;
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
  padding: 16px;
  transition: box-shadow 0.2s ease;
}

.card:hover {
  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.12);
}

카드 변형

• 기본 카드: 배경 흰색, 그림자 있음
• 강조 카드: 배경 primary-light, 좌측 4px primary 보더
• 진행 중 카드: 배경 흰색, 좌측 4px ongoing 보더

---

7. 버튼 디자인

Primary Button (주요 액션)

.btn-primary {
  background: var(--primary);
  color: var(--white);
  padding: 12px 24px;
  border-radius: 8px;
  font-size: 16px;
  font-weight: 500;
  border: none;
  transition: background 0.2s ease;
}

.btn-primary:hover {
  background: var(--primary-dark);
}

Secondary Button (보조 액션)

.btn-secondary {
  background: transparent;
  color: var(--primary);
  padding: 12px 24px;
  border-radius: 8px;
  font-size: 16px;
  font-weight: 500;
  border: 1px solid var(--primary);
}

.btn-secondary:hover {
  background: var(--primary-light);
}

Ghost Button (최소 강조)

.btn-ghost {
  background: transparent;
  color: var(--gray-700);
  padding: 8px 16px;
  border-radius: 8px;
  font-size: 14px;
  border: none;
}

.btn-ghost:hover {
  background: var(--gray-100);
}

FAB (Floating Action Button)

.fab {
  width: 56px;
  height: 56px;
  background: var(--primary);
  color: var(--white);
  border-radius: 50%;
  box-shadow: 0 4px 12px rgba(77, 213, 167, 0.4);
  position: fixed;
  bottom: 24px;
  right: 24px;
}

---

8. 배지 (Badges)

상태 배지

/* 완료 */
.badge-complete {
  background: var(--success);
  color: var(--white);
  padding: 4px 8px;
  border-radius: 12px;
  font-size: 12px;
}

/* 진행중 */
.badge-ongoing {
  background: var(--ongoing);
  color: var(--white);
  padding: 4px 8px;
  border-radius: 12px;
  font-size: 12px;
  animation: pulse 1.5s ease-in-out infinite;
}

/* 예정 */
.badge-scheduled {
  background: var(--info);
  color: var(--white);
  padding: 4px 8px;
  border-radius: 12px;
  font-size: 12px;
}

/* 지연 */
.badge-overdue {
  background: var(--error);
  color: var(--white);
  padding: 4px 8px;
  border-radius: 12px;
  font-size: 12px;
}

우선순위 배지

/* 높음 */
.badge-high {
  background: #FFEBEE;
  color: #D32F2F;
  border: 1px solid #EF9A9A;
}

/* 보통 */
.badge-medium {
  background: #FFF3E0;
  color: #F57C00;
  border: 1px solid #FFCC80;
}

/* 낮음 */
.badge-low {
  background: #E8F5E9;
  color: #388E3C;
  border: 1px solid #A5D6A7;
}

---

9. 아이콘

아이콘 라이브러리

• Material Icons 또는 Feather Icons 권장
• 일관된 스타일 유지 (Outlined 또는 Rounded)

아이콘 크기

--icon-sm: 16px;              /* 인라인 아이콘 */
--icon-md: 24px;              /* 기본 아이콘 */
--icon-lg: 32px;              /* 강조 아이콘 */

주요 아이콘 매핑

• 회의: 📅 calendar
• Todo: ✅ check-circle
• 녹음: 🎙️ mic
• 참석자: 👤 user
• 설정: ⚙️ settings
• 검색: 🔍 search
• 알림: 🔔 bell
• 링크: 🔗 link

---

10. 네비게이션

하단 네비게이션 (Mobile)

.bottom-nav {
  height: 64px;
  background: var(--white);
  border-top: 1px solid var(--gray-300);
  box-shadow: 0 -2px 8px rgba(0, 0, 0, 0.08);
}

.nav-item {
  flex: 1;
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 4px;
  color: var(--gray-500);
}

.nav-item.active {
  color: var(--primary);
}

탭 네비게이션

.tab {
  padding: 12px 16px;
  color: var(--gray-500);
  border-bottom: 2px solid transparent;
  transition: all 0.2s ease;
}

.tab.active {
  color: var(--primary);
  border-bottom: 2px solid var(--primary);
  font-weight: 500;
}

---

11. 폼 요소

Input Field

.input {
  width: 100%;
  padding: 12px 16px;
  border: 1px solid var(--gray-300);
  border-radius: 8px;
  font-size: 16px;
  background: var(--white);
  transition: border-color 0.2s ease;
}

.input:focus {
  border-color: var(--primary);
  outline: none;
  box-shadow: 0 0 0 3px rgba(77, 213, 167, 0.1);
}

.input::placeholder {
  color: var(--gray-500);
}

Checkbox

.checkbox {
  width: 20px;
  height: 20px;
  border: 2px solid var(--gray-300);
  border-radius: 4px;
  transition: all 0.2s ease;
}

.checkbox:checked {
  background: var(--primary);
  border-color: var(--primary);
}

---

12. 모달 & 다이얼로그

모달 오버레이

.modal-overlay {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background: rgba(0, 0, 0, 0.5);
  backdrop-filter: blur(4px);
  z-index: 1000;
}

모달 콘텐츠

.modal {
  background: var(--white);
  border-radius: 16px 16px 0 0; /* Mobile: Bottom Sheet */
  max-width: 480px;
  padding: 24px;
  box-shadow: 0 -4px 16px rgba(0, 0, 0, 0.16);
}

/* Desktop: Centered Modal */
@media (min-width: 768px) {
  .modal {
    border-radius: 16px;
    margin: auto;
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
  }
}

---

13. 애니메이션

트랜지션

--transition-fast: 0.15s ease;
--transition-normal: 0.2s ease;
--transition-slow: 0.3s ease;

주요 애니메이션

Fade In

@keyframes fadeIn {
  from { opacity: 0; }
  to { opacity: 1; }
}

Slide Up (Bottom Sheet)

@keyframes slideUp {
  from { transform: translateY(100%); }
  to { transform: translateY(0); }
}

Pulse (진행 중 배지)

@keyframes pulse {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.7; }
}

---

14. 접근성 (Accessibility)

색상 대비

• WCAG 2.1 Level AA 준수
• 텍스트와 배경 대비율: 최소 4.5:1
• 큰 텍스트(18px+) 대비율: 최소 3:1

포커스 스타일

:focus-visible {
  outline: 2px solid var(--primary);
  outline-offset: 2px;
}

터치 타겟

• 최소 크기: 44x44px (iOS), 48x48px (Android)
• 터치 타겟 간 최소 간격: 8px

---

15. 반응형 디자인

Mobile First 접근

/* Mobile (기본) */
.container {
  padding: 16px;
}

/* Tablet (768px+) */
@media (min-width: 768px) {
  .container {
    padding: 24px;
  }
}

/* Desktop (1024px+) */
@media (min-width: 1024px) {
  .container {
    padding: 32px;
  }
}

---

참조 이미지 분석 결과

확인된 디자인 특징 (reference/sampleimg 기반)

1. Primary Color: #4DD5A7 (민트 그린) - 모든 액션 버튼과 강조 요소에 사용
2. 카드 디자인: 흰색 배경, 12px 둥근 모서리, 미세한 그림자
3. 타이포그래피: 명확한 계층 구조, 충분한 여백
4. 아바타: 원형, 다양한 색상 배경 (팀원 구분)
5. 배지: 둥근 모서리, 명확한 색상 코딩 (진행 중=주황, 완료=민트)
6. 간격: 16px 기본 간격 일관 적용
7. 섹션 구분: 미세한 구분선 또는 배경색 차이로 구분

---

변경 이력

버전	날짜	작성자	변경 내용
1.0	2025-10-21	최유진	최초 작성 - reference/sampleimg 샘플 이미지 기반 스타일 가이드 작성