---
title: "📓 작업일지 — 테마 기본값을 다크 고정 → 시스템 설정 따름으로 전환"
category: "worklog"
parent: "Claude Code 작업일지"
updated: "2026-07-03"
priority: "Low"
purpose: "신규·미선택 사용자의 기본 테마값을 다크 고정에서 시스템(OS) 설정을 따르도록 변경한 기록. 명시적으로 dark/light/system을 선택한 기존 사용자의 설정은 그대로 보존된다."
read_when: ["테마 기본값", "loadThemePref", "system 테마", "FOUC 스크립트"]
document_type: "개발일지"
source_status: "generated"
knowledge_group: "03_history"
work_timestamp: "20260703_224121"
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
context: "달록 본레포(ccy-hansbridge/dallog), 커밋 c38bc2e(2026-07-03)."
---

# 작업일지 — 테마 기본값을 시스템 설정 따름으로 전환

## 1. 무엇을 했나

- `loadThemePref()`: 저장된 테마 설정이 없을 때(null) 기본값을 `'dark'`에서 `'system'`으로 변경. 사용자가 명시적으로 `'dark'`/`'light'`/`'system'`을 선택한 경우는 그 값을 그대로 보존.
- `index.html`의 FOUC(Flash of Unstyled Content) 방지 스크립트도 `|| 'dark'`에서 `|| 'system'`으로 일치시켜, 페인트 이전(pre-paint) 단계부터 시스템 설정에 대응하도록 수정.
- `App.tsx`는 이미 system 구독 처리가 되어 있어 별도 변경이 필요하지 않았음.
- `npm run build(tsc)` 통과 확인.

## 2. 주요 변경 파일

| 파일 | 내용 |
|---|---|
| `src/lib/theme.ts` | `loadThemePref()` 기본값 `dark` → `system` |
| `index.html` | FOUC 스크립트 기본값 일치 |

## 3. 관련 커밋

- `c38bc2e` feat(theme): 기본 테마값 다크고정 → 시스템 설정 따름(신규/미선택 사용자) (2026-07-03)

## 4. 남은 이슈

커밋 기준 별도로 언급된 남은 이슈는 없음.