Skip to content

Latest commit

 

History

History
51 lines (39 loc) · 2.56 KB

File metadata and controls

51 lines (39 loc) · 2.56 KB

0031. 단일 Paper 테마를 채택하고 명령 팔레트를 제거한다

Date: 2026-07-19 Status: Accepted

배경

Ark의 공개 글 수와 탐색 깊이는 별도 검색 기능이 필요한 규모가 아니다. 고정 검색 입력창과 명령 팔레트는 콘텐츠보다 앱 셸을 먼저 인식하게 만들었고, 라이트·다크 전환은 같은 읽기 경험에 두 개의 색 체계와 클라이언트 상태를 추가했다.

홈 아카이브를 날짜와 제목의 행 목록으로 단순화한 뒤에도, 검색과 테마 제어가 남아 있으면 화면의 밀도와 제품적인 인상이 다시 커진다. 코드 예시는 긴 글에서 구분되어야 하므로, 본문 표면과 코드 표면을 같은 밝기로 만들 필요는 없다.

결정

  • UI는 Paper 팔레트 하나만 사용한다. 기본 표면은 #F4F3EF, 본문 잉크는 #24241F, 보조 텍스트는 #62625A, 구분선은 #DAD9D2, 강조색은 #2F6B5F로 둔다.
  • 라이트·다크 선택, 시스템 테마 동기화, 전환 애니메이션을 제거한다.
  • 전역 검색 입력창, / 단축키, KBar 명령 팔레트와 search/ 도메인을 제거한다.
  • Giscus는 고정된 밝은 임베드 테마를 사용하고 Mermaid는 중립 렌더링 테마를 사용한다.
  • 코드 블록은 어두운 잉크 표면을 유지한다. 이는 사이트 테마가 아니라 읽기 중 코드와 본문을 구분하는 콘텐츠 토큰이다.

결과

  • 탐색은 섹션 내비게이션과 홈 카테고리 링크로 집중된다.
  • kbar, next-themes 및 해당 클라이언트 provider가 사라져 앱 셸의 런타임 상태와 의존성이 줄어든다.
  • 테마 선택을 제공하지 않으므로, 향후 어두운 테마를 다시 도입하려면 색상 토큰, 임베드, 접근성 대비, 브라우저 회귀 검증을 함께 설계하는 새 ADR이 필요하다.

검토한 대안

  • 시스템 설정에 따라 자동 전환한다: 사용자 선택 UI는 줄지만 두 색 체계와 검증 범위는 그대로 남는다.
  • 테마 전환만 제거하고 다크 모드는 유지한다: 화면의 제품적 복잡도와 유지보수 범위가 충분히 줄지 않는다.
  • 검색만 숨기고 KBar를 보존한다: 공개 탐색 경로로 사용하지 않는 기능과 의존성이 계속 남는다.

Related History