Skip to content

docs: document dark theme behavior#270

Merged
version-1 merged 1 commit into
mainfrom
docs/218-dark-mode-docs
Jul 12, 2026
Merged

docs: document dark theme behavior#270
version-1 merged 1 commit into
mainfrom
docs/218-dark-mode-docs

Conversation

@version-1

Copy link
Copy Markdown
Owner

ダークモードの設計ドキュメントを同期

Summary

ダークモードの実装契約を、Web UI の英語・日本語の設計文書へ同期しました。初期テーマ決定、利用者の明示的な選択の保存、CSS トークンによる配色切替を、実装に合わせて明文化しています。

主な変更点:

  • tasq.themeprefers-color-scheme の優先順位を記載
  • 初回描画前の html[data-theme] 設定と、実行時の追従条件を記載
  • セマンティック CSS トークンによるライト・ダークテーマの切替規約を記載

チケットへのリンク

#218

やったこと

  • docs/design/web.md と日本語版にテーマ仕様を追加
  • フロントエンドの責務配置文書に use-theme.ts の所有範囲を追加
  • UI デザインシステム文書にトークン切替と永続化の契約を追加

動作確認

  • git diff --check
  • index.htmluse-theme.tsglobals.css と文書の記載を照合
  • 英語版・日本語版のテーマ契約を同期

レビュー & 動作確認 チェックリスト

  • 初期テーマの優先順位 - 保存済みの tasq.theme が OS 設定より優先されること
  • 実行時の追従条件 - 保存値がない場合だけ OS 設定変更に追従すること
  • トークン切替 - html[data-theme] と意味的な CSS トークンでテーマを切り替えること

推奨テスト計画:

  1. localStoragelight または dark を設定してページを再読込する。
  2. 保存値を削除し、OS の配色設定に応じて初期テーマが変わることを確認する。
  3. サイドバーのテーマ切替後に、選択が再読込後も維持されることを確認する。

その他気になることや相談ごと

特になし。

Requested by: @admin

Document initial theme resolution, persisted preference behavior, and CSS token switching in synchronized English and Japanese Web UI design guides.\n\nVerification: git diff --check and implementation-to-documentation review.
@version-1 version-1 merged commit 749c126 into main Jul 12, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant