Skip to content

feat: add per-mode theme overrides - #2324

Open
aneym wants to merge 1 commit into
herdrdev:masterfrom
aneym:pr/theme-custom-modes
Open

feat: add per-mode theme overrides#2324
aneym wants to merge 1 commit into
herdrdev:masterfrom
aneym:pr/theme-custom-modes

Conversation

@aneym

@aneym aneym commented Aug 4, 2026

Copy link
Copy Markdown

Summary

[theme.custom] applies one set of overrides in both modes, so with auto_switch a value tuned for the dark theme washes out when the light theme activates. #837 proposed per-mode blocks and @ogulcancelik approved a PR there.

This adds [theme.custom.light] and [theme.custom.dark]. Resolution order: theme defaults, then [theme.custom], then the block matching the resolved appearance. Configs that do not use the new blocks resolve exactly as they do today.

[theme]
auto_switch = true

[theme.custom]
accent = "#fe640b"

[theme.custom.light]
text = "#2e3145"
subtext0 = "#494c66"

before and after: sidebar rows in the light theme, with and without a light-mode override

Both panes are the same seeded layout rendered with catppuccin-latte active; the only difference is the [theme.custom.light] block.

Refs #837. #2032 asks for the same capability from a full-theme-pair angle; this shape covers it through [theme.custom.light]/[theme.custom.dark] alone.

Test plan

  • Rebased onto current master (ffc4e263).
  • Focused theme tests: 4 passed, covering parsing both blocks, shared-vs-mode precedence, active light/dark resolution, manual-mode fallback, and sidebar_bg/new sidebar row color tokens.
  • Full nextest run: 3,329 passed, 3 failed. The failures are unrelated PTY/process timing tests (live_handoff x2 and api_ping pane-info); rerunning the CI suite with exactly those three excluded passed all 3,329 remaining Rust tests plus fmt, clippy, UI architecture, integration assets, and plugin marketplace checks.
  • just windows-lint: passed.
  • Maintenance script suite: 98 passed, including config-reference parity, docs translation parity, and Windows ConPTY packaging.

@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 888c5028-89cb-4dfc-ba0b-a18b790ddc33

📥 Commits

Reviewing files that changed from the base of the PR and between ffc4e26 and 47b056c.

📒 Files selected for processing (7)
  • docs/next/website/src/content/docs/configuration.mdx
  • docs/next/website/src/data/config-reference.json
  • src/app/mod.rs
  • src/app/state.rs
  • src/config.rs
  • src/config/theme.rs
  • src/main.rs
🚧 Files skipped from review as they are similar to previous changes (7)
  • src/config.rs
  • src/app/state.rs
  • src/main.rs
  • src/config/theme.rs
  • docs/next/website/src/data/config-reference.json
  • docs/next/website/src/content/docs/configuration.mdx
  • src/app/mod.rs

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.


📝 Walkthrough

Walkthrough

The theme configuration now supports light- and dark-appearance custom color overrides. Automatic theme switching applies active mode overrides after shared custom and legacy accent colors. Tests and documentation cover the new behavior.

Changes

Theme appearance overrides

Layer / File(s) Summary
Theme configuration contract
src/config/theme.rs, src/config.rs
CustomThemeColors defines optional light and dark ModeThemeColors tables. Deserialization tests cover their color values. The type is publicly re-exported.
Mode-aware palette resolution
src/app/state.rs, src/app/mod.rs
Automatic theme selection passes active mode overrides to palette resolution. Palette::with_mode_overrides applies token values after shared custom and legacy accent colors. Tests verify precedence and fallback behavior.
Configuration documentation and examples
docs/next/website/src/content/docs/configuration.mdx, docs/next/website/src/data/config-reference.json, src/main.rs
Documentation, reference data, and default examples describe light and dark appearance-specific color settings.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 47b05

The PR adds per-mode theme overrides while preserving existing behavior for configurations that do not use them; no actionable merge-blocking risk remains after normal checks and review.

Sequence Diagram(s)

sequenceDiagram
  participant HostAppearance
  participant resolve_effective_theme
  participant resolve_palette_for_theme_name
  participant Palette
  HostAppearance->>resolve_effective_theme: select light or dark appearance
  resolve_effective_theme->>resolve_palette_for_theme_name: pass active mode overrides
  resolve_palette_for_theme_name->>Palette: apply shared custom colors
  Palette->>Palette: apply active mode-specific colors
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 57.14% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly and concisely identifies the main change: adding per-mode theme overrides.
Description check ✅ Passed The description accurately explains the new configuration blocks, resolution order, compatibility, tests, and validation results.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@kangal-bot

Copy link
Copy Markdown
Collaborator

Hi @aneym, thanks for your interest in contributing!

Herdr automatically admits focused bug fixes from contributors who are not maintainers when the title uses fix: ... or fix(scope): ... and the patch changes no more than 20 files and 1,000 total added or deleted lines.

Contributors who are not maintainers may submit only focused bug fixes. If this pull request fixes a bug, rename it to use a conventional fix: ... or fix(scope): ... title, then tag a maintainer to review and reopen it.

Feature requests, behavior changes, and other proposals belong in GitHub Discussions and require maintainer approval before a pull request.

If this gate classified the pull request incorrectly, reply and tag a maintainer listed in .github/MAINTAINERS. A verified maintainer can reopen it; reopening by anyone else will be closed again automatically.

Patch size: 7 changed files, 391 changed lines.

See https://github.com/herdrdev/herdr/blob/master/CONTRIBUTING.md for the contribution policy.

@kangal-bot kangal-bot closed this Aug 4, 2026
@ogulcancelik ogulcancelik reopened this Aug 4, 2026
@kangal-bot kangal-bot added ai-review Trigger automated AI reviews for pull requests admitted by the PR gate maintainer-approved PR scope explicitly approved by a maintainer labels Aug 4, 2026
@greptile-apps

greptile-apps Bot commented Aug 4, 2026

Copy link
Copy Markdown

Greptile Summary

The PR adds light- and dark-specific custom color overrides that activate with automatic appearance switching while preserving existing shared overrides.

  • Extends theme configuration with [theme.custom.light] and [theme.custom.dark].
  • Layers the resolved mode override after built-in and shared custom colors.
  • Documents every new configuration key and adds parsing and resolution coverage.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
src/app/mod.rs Resolves the active appearance-specific override after shared colors while retaining manual-mode behavior.
src/app/state.rs Adds complete palette application for all supported mode-specific color tokens.
src/config/theme.rs Defines and tests deserialization of light and dark custom color subtables.
docs/next/website/src/data/config-reference.json Documents the complete light and dark override key sets.
docs/next/website/src/content/docs/configuration.mdx Explains configuration syntax and override precedence.
src/main.rs Adds commented per-mode override examples to the generated default configuration.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Built-in theme palette] --> B[Apply theme.custom]
  B --> C{auto_switch enabled?}
  C -->|No| D[Effective palette]
  C -->|Yes, light| E[Apply theme.custom.light]
  C -->|Yes, dark| F[Apply theme.custom.dark]
  E --> D
  F --> D
Loading

Reviews (7): Last reviewed commit: "feat: add per-mode theme overrides" | Re-trigger Greptile

Comment thread src/app/mod.rs
@aneym
aneym force-pushed the pr/theme-custom-modes branch from 66ee3b8 to d1a4e65 Compare August 8, 2026 02:55

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
src/config/theme.rs (1)

126-146: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Add sidebar_bg to mode-specific overrides.

ModeThemeColors omits sidebar_bg, although CustomThemeColors and Palette support it. A user cannot set a light-only or dark-only sidebar background.

Add sidebar_bg to ModeThemeColors. Apply it in Palette::with_mode_overrides. Add parsing and palette-resolution coverage.

Proposed fix
--- a/src/config/theme.rs
+++ b/src/config/theme.rs
 pub struct ModeThemeColors {
     pub accent: Option<String>,
     pub panel_bg: Option<String>,
+    pub sidebar_bg: Option<String>,
     pub surface0: Option<String>,
--- a/src/app/state.rs
+++ b/src/app/state.rs
         if let Some(c) = &custom.panel_bg {
             self.panel_bg = parse_color(c);
         }
+        if let Some(c) = &custom.sidebar_bg {
+            self.sidebar_bg = parse_color(c);
+        }

Based on supplied downstream context, src/app/state.rs:641-692 has the same omission.


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1cefb19c-6dd0-416f-9a93-164b72966a75

📥 Commits

Reviewing files that changed from the base of the PR and between 66ee3b8 and d1a4e65.

📒 Files selected for processing (7)
  • docs/next/website/src/content/docs/configuration.mdx
  • docs/next/website/src/data/config-reference.json
  • src/app/mod.rs
  • src/app/state.rs
  • src/config.rs
  • src/config/theme.rs
  • src/main.rs
🚧 Files skipped from review as they are similar to previous changes (6)
  • docs/next/website/src/content/docs/configuration.mdx
  • docs/next/website/src/data/config-reference.json
  • src/main.rs
  • src/app/state.rs
  • src/app/mod.rs
  • src/config.rs

@aneym
aneym force-pushed the pr/theme-custom-modes branch from d1a4e65 to baff68f Compare August 8, 2026 08:57
@aneym

aneym commented Aug 8, 2026

Copy link
Copy Markdown
Author

Added sidebar_bg to the per-mode overrides in baff68f: field on ModeThemeColors, applied in with_mode_overrides, covered in the parse and palette-resolution tests, and documented under theme.custom.light/theme.custom.dark in the config reference.

@aneym
aneym force-pushed the pr/theme-custom-modes branch 2 times, most recently from bd6babf to 1c53cf1 Compare August 11, 2026 02:55
@aneym
aneym force-pushed the pr/theme-custom-modes branch from 1c53cf1 to 47b056c Compare August 20, 2026 01:07
@aneym

aneym commented Aug 20, 2026

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 20, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai

coderabbitai Bot commented Aug 20, 2026

Copy link
Copy Markdown

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

allow [theme.custom.light] and [theme.custom.dark] blocks so custom
overrides can differ per resolved appearance when auto_switch flips.
precedence: theme defaults, then [theme.custom], then the block for
the active mode. configs without the new blocks resolve unchanged.

refs herdrdev#837
@aneym
aneym force-pushed the pr/theme-custom-modes branch from 47b056c to 14e5036 Compare August 20, 2026 13:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-review Trigger automated AI reviews for pull requests admitted by the PR gate maintainer-approved PR scope explicitly approved by a maintainer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants