Files
music_quiz/docs/03-ui-design.md

4.5 KiB

03. UI · 디자인

방향

joke-app의 뼈대(상단 헤더, 방 바, 대기실 2단, 게임 3단, 시트, 토스트, 관리자 레이아웃)는 그대로 쓰고, 색과 형태를 "동네 레코드 가게" 느낌으로 바꾼다.

  • 종이색 바탕 + 먹색 테두리 + 청록 + 겨자색. LP 판, 레이블 스티커, 점선 티켓 같은 소품을 조금씩만
  • "AI가 만든 것 같은" 느낌을 피하기 위해 하지 않는 것: 보라-파랑 그라데이션, 유리(블러) 카드, 네온 글로우, 의미 없는 반짝이 아이콘, 모든 걸 가운데 정렬한 카드 나열, 회색 그림자만 있는 밋밋한 카드
  • 대신: 2px 먹색 테두리, 버튼 아래쪽 3px 단색 그림자(눌리는 키캡 느낌), 살짝 어긋난 인쇄 그림자(LP), 아주 옅은 종이 질감 점무늬
  • 정보 밀도는 높게. 게임 중엔 채팅이 주인공이라 장식은 최소화

색 (라이트)

이름 값 쓰임
--bg #F5EFE3 바탕(종이)
--surface #FFFDF8 카드
--surface-2 #EFE6D3 보조 면, 세부 설정 상자
--ink #1E1B18 글자, 테두리, 선택된 버튼
--text-sub #6B6157 보조 글자
--line #DDD2BE 옅은 구분선
--primary #1F6F78 청록 — 주요 버튼, 선택 칩, 진행 막대
--mustard #F2B544 겨자 — 게임 시작, 정답 밑줄, 강조
--coral #E4573D 진행 중 배지, 가사 모드 시간 막대
--correct #2F8F4E 정답 줄

다크 테마도 joke-app처럼 제공([data-theme=dark]): 바탕 #17150F, 카드 #221F1A, 테두리 #E9DFC9, 청록 #4FA9B2, 겨자 그대로.

난이도 별 색 (단계가 올라갈수록 뜨거워지는 느낌)

단계 색 느낌
1~3 #F2B544 겨자 쉬움
4~6 #EF8A3A 주황 보통
7~8 #DC4B3E 빨강 어려움
9~10 #6B3FB5 보라 극악
빈 별은 같은 색 테두리만, 찬 별은 색으로 채움.

채팅 이름 색

사용자별 고정 색(이름 해시 → 색상환). 정답 초록과 헷갈리지 않게 연두·초록 구간(60°~160°)은 뺀다.

글꼴 · 크기

  • Pretendard 가변(joke-app과 같음). 본문 500, 제목 800, 숫자는 고정폭 숫자(tabular-nums)
  • 기본 15px, 채팅 16px, 채팅 입력 17~18px, 정답 블록 20px
  • 글자 크기 키우기(보통/크게/아주 크게) 개인 설정 유지

형태

  • 모서리 14px(카드), 11~12px(버튼·입력), 999px(칩)
  • 주요 컨트롤은 2px 먹색 테두리 + 아래 3px 그림자, 누르면 그림자 0 + 2px 내려감
  • 터치 영역 최소 44px

아이콘

assets/brand/ — LP 판 가운데 레이블에 물음표, 오른쪽 위에 톤암. 청록 바탕, 겨자 레이블.

  • 사이트 헤더 로고, 파비콘(16~64px는 단순화 버전), PWA(192/512), 애플 터치(180)
  • 디스코드 앱 아이콘: icon-discord-1024.png (꽉 찬 사각형, 디스코드가 원으로 자름)

화면별 구성 (예시 이미지: docs/mockups/out/*.png)

첫 화면 /

  • 왼쪽 큰 카드: 한 줄 소개 + 방 만들기 코드로 참여
  • 오른쪽: 디스코드 로그인 / 게스트 닉네임
  • 아래: 열린 방 목록(대기/진행 중 필터, 중간 참여 버튼, 방 설정 요약 배지)

대기실 /r/:code

  • 상단 방 바: 방 이름, 6자리 코드(점선 티켓), 링크 복사, 인원 "제한 없음", 나가기
  • 왼쪽: 참가자 격자(방장 👑, 준비 배지), "조건에 맞는 곡 N곡" + 게임 시작, 채팅
  • 오른쪽: 방 설정 카드(겨자색 머리). 방장만 바꿀 수 있고 다른 사람은 읽기 전용

게임 화면

  • 맨 위 검은 띠: 문제 번호, 모드 배지, 힌트/스킵 버튼(단축키 표시, 투표 수)
  • 가운데 위: 무대(돌아가는 LP + 재생 막대 + 힌트 초성) — 높이 190px로 낮게
  • 가운데 아래: 채팅(화면에서 가장 큼)
  • 왼쪽: 점수판 / 오른쪽: 지난 문제(정답, 정답자, 걸린 시간, 난이도)
  • 1100px 미만: 양옆 접힘, 휴대폰: 무대는 상단 띠, 점수는 가로 스크롤 칩, 입력창 옆 💡 ⏭ 버튼

관리자 /admin

  • joke-app 관리자와 같은 사이드 메뉴 + 표 구조, 노래 화면은 표 + 오른쪽 편집 패널(유튜브 후보·미리듣기·하이라이트 지정)

접근성

  • 색만으로 구분하지 않기(정답 줄 ✔, 난이도 숫자 병기)
  • 대비 4.5:1 이상, 키보드만으로 모든 조작, joke-app의 axe 검사 e2e 그대로
  • 소리: 볼륨 개인 설정, 정답/오답 효과음 끄기