Keep settings tuned for one theme from applying under every other theme

Open
#666 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
macos, swift
Domain
design, desktop

Research direction

Start with Sources/StableBar/ThemeConfiguration.swift and Sources/StableBar/ConfigurationLoader.swift to understand profile conditions and when the selected theme is resolved; then read Sources/StableBar/WidgetPackage.swift and Sources/StableBar/Configuration.swift for theme and configuration validation. The proposal also spans profile editing, Theme and widget Style settings, and undoable configuration changes, so identify those entry points before estimating implementation. Done means theme conditions match the selected theme as described and theme scoped settings can be edited and migrated in Settings.

Written by the indexing model from the issue text.

Description

enhancement

Problem

A theme can't hold everything its look needs. A theme may contain only tokens, defaults, popupDefaults, roles, workspaceDefaults, bar, groups and profiles (validateThemeDocument in Sources/StableBar/WidgetPackage.swift), so the rest of the look goes in the main file:

  • widget paddings sized for the theme's pills
  • a clock drawn as an accent chip
  • a filled slider style
  • an Apple menu symbol
  • a package widget's layout in widgetOverrides
  • empty groups entries, needed only because a widget in a group the theme doesn't define fails the whole configuration ("Unknown group" in Sources/StableBar/Configuration.swift)

Those values apply under every theme. Switch from Fern to Nord and the clock is still an @token.accent chip, and the widgets keep paddings meant for pills. Theme lists the values below the gallery, and Reset them deletes them, so going back to Fern means doing the work again.

Profiles can't help: they match appearance, onBattery, displayCount, externalDisplay and app (ProfileConditions in Sources/StableBar/ThemeConfiguration.swift), not the theme.

Proposal

  1. A theme profile condition that matches the selected theme's ID, at any version, with "built-in" for Built-in:

    "profiles": [
      {
        "name": "Fern",
        "when": { "theme": "fern" },
        "configuration": {
          "widgetOverrides": {
            "date": { "group": "clock", "background": "@token.accent" },
            "battery": { "group": "status", "style": { "paddingHorizontal": 12 } }
          },
          "groups": { "clock": { "style": { "paddingLeading": 3 } } }
        }
      }
    ]
    

    composeFiles in Sources/StableBar/ConfigurationLoader.swift settles the theme before profiles apply, including a screen setup's own theme and the theme Try Themes shows, so the condition reads that theme and a profile can't change it in a loop. Group memberships can move into the profile too, so the main file no longer needs empty groups. Versions that don't know the condition never match it (Files from a newer StableBar), so the profile just stays off there.

  2. Settings → Profiles → + Condition offers Theme, listing the built-in and installed themes.

  3. At the top of Theme and in a widget's Style tab, a scope switch: Every theme or Only with Fern. With Only with Fern, changes save into a profile with that condition, created on first use, the way Edit the bar for this profile saves into a profile today.

  4. When the main file overrides the theme, Theme's notice offers to keep those values with a theme as well as Reset them: it moves them into that theme's profile in one undoable change.

The exact wording and placement of the switch and the notice are a matter of taste; renders of a few options can follow in a comment.

Possible today

Partly. Put the settings in a profile without when and turn it off with "enabled": false when switching theme, or pin it with "profile" or StableBar --profile. Pinning turns off automatic matching for every other profile, and nothing ties either way to the theme.

Related

  • #81 asked for profile conditions set by commands and was closed as not planned ("--profile covers most of it"). The theme is different: StableBar already knows it, and pinning a profile turns off automatic matching for the others.
  • #28 stopped colors that StableBar wrote from overriding a chosen theme, #30 lists what overrides the theme, and Save as Theme (#91, #143) moves the shared look into a theme but leaves widget styles in the main file.
  • #648 (open) adds group editing in Settings, which writes groups and widget group.
  • Themes that carry named looks (any role name, with roles and groups the theme lacks ignored) were considered instead. They would let a theme package ship reusable looks, but they change what a role is, and they can't hold a widget's own layout or symbol.

Triaged by Claude Code (Claude Opus 5.5).

Dominant language
Swift
Stars
184
Forks
12
Avg merge
3h 50m
Merged PRs (30d)
387

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Seb-GRAF/StableBar

All issues in Seb-GRAF/StableBar

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.