Skip to content

Feature/issue #534 customer branding via --oscd-theme-* and clearer plugin tokens - #169

Draft
brabenetz wants to merge 10 commits into
com-pas:mainfrom
brabenetz:feature/issue-534_customer-branding
Draft

Feature/issue #534 customer branding via --oscd-theme-* and clearer plugin tokens#169
brabenetz wants to merge 10 commits into
com-pas:mainfrom
brabenetz:feature/issue-534_customer-branding

Conversation

@brabenetz

@brabenetz brabenetz commented Aug 18, 2026

Copy link
Copy Markdown

Separates host branding from OpenSCD core. Hosts override only --oscd-theme-*
(customer-branding.css). Plugins consume resolved --oscd-* tokens.

  • Backward compatible: existing plugins keep their current look.
  • Simpler corporate branding: one CSS file, light-dark() or a fixed primary,
    independent contrast tokens (--oscd-on-*, --oscd-paper / --oscd-ink).
  • More flexible plugin theming without forking themes.ts.
  • Host branding docs: docs/how-to/customer-branding.md
  • Plugin theming docs: docs/how-to/plugin-theming.md
    (token list: docs/how-to/theme-tokens.md)
  • A Workaround Description for new plugins who want already use --oscd-theme-* on old hosts that do not publish the full token set yet (best effort for the transition).

… API

Remove unused --oscd-used-scheme. Keep getTheme(theme) for fork compatibility.
Route MWC error and icon-font through --oscd-theme-* so branding reaches Material
components. Document customer-branding.css, including --oscd-theme-body-bg as an
independent override from --oscd-theme-base2.
Replace --oscd-white/--oscd-black with --oscd-paper/--oscd-ink (lightest
ground / darkest mark; values swap in dark mode). Document --oscd-theme-*
including branding id, warning/success, and host vs plugin usage.

docs/how-to/customer-branding.md
docs/how-to/plugin-theming.md
docs/how-to/theme-tokens.md
@brabenetz brabenetz changed the title Feature/issue 534 customer branding Feature/issue 534 customer branding via --oscd-theme-* and clearer plugin tokens Aug 20, 2026
@brabenetz brabenetz changed the title Feature/issue 534 customer branding via --oscd-theme-* and clearer plugin tokens Feature/issue #534 customer branding via --oscd-theme-* and clearer plugin tokens Aug 21, 2026
Align the active-tab ink token with the --oscd-on-primary contrast pair.
Host override is now --oscd-theme-on-primary-active. Default is unchanged
(--oscd-on-primary).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

1 participant