From af58d0b9ac0c2198532b4dc66027245687345ff5 Mon Sep 17 00:00:00 2001 From: Benjamin Lu Date: Mon, 2 Nov 2026 16:20:11 -0800 Subject: [PATCH 1/6] feat(design-system): add the Void theme for apps other than ComfyUI Void is the near-black look Comfy Desktop is moving to. It lives in its own file that ComfyUI never imports, so changing it cannot change ComfyUI. Package components also need icons, overlay animations, stacking layers, small text sizes and scrollbar utilities that only theme.css provided, alongside ComfyUI's colors and app-wide rules. Move those into component-support.css so another host can load them without the rest of theme.css. ComfyUI's compiled CSS keeps the same rules in the same cascade order, except for one dead utility: bg-(--surface-ground) read a variable nothing defines. --- packages/design-system/README.md | 19 ++++ .../common/NoResultsPlaceholder.vue | 2 +- .../src/css/component-support.css | 69 ++++++++++++ packages/design-system/src/css/theme.css | 76 +------------ .../design-system/src/css/themes/void.css | 102 ++++++++++++++++++ .../design-system/src/css/themes/void.test.ts | 90 ++++++++++++++++ .../tests/css-consumer/verifyStyles.ts | 22 +++- .../tests/css-consumer/void-theme.css | 2 + 8 files changed, 305 insertions(+), 77 deletions(-) create mode 100644 packages/design-system/src/css/component-support.css create mode 100644 packages/design-system/src/css/themes/void.css create mode 100644 packages/design-system/src/css/themes/void.test.ts create mode 100644 packages/design-system/tests/css-consumer/void-theme.css diff --git a/packages/design-system/README.md b/packages/design-system/README.md index 26fdeaf3d15..aa77d32b06d 100644 --- a/packages/design-system/README.md +++ b/packages/design-system/README.md @@ -34,6 +34,23 @@ For the palette and fonts without the Tailwind layers or icon plugins: @import '@comfyorg/design-system/css/base.css'; ``` +## Void theme + +Void is the near-black look used by Comfy Desktop. An app with its own Tailwind +build and global styles imports it instead of `style.css`, which carries +ComfyUI's colors and app-wide rules: + +```css +@import 'tailwindcss'; +@import '@comfyorg/design-system/css/themes/void.css'; +``` + +The theme gives the components their colors, registers the compiled component +sources for Tailwind, and adds Void's type, radius, shadow and motion tokens. +ComfyUI does not import it, so changing Void cannot change ComfyUI. It does not +declare fonts: the host provides `Inter` and `PP Formula`. Published consumers +still import `components.css`, as described under [Vue components](#vue-components). + ## Exports | Path | Contents | @@ -41,6 +58,8 @@ For the palette and fonts without the Tailwind layers or icon plugins: | `./css/style.css` | Full theme — palette, fonts, Tailwind layers, icon plugins | | `./css/theme.css` | Full theme without automatic component source registration | | `./css/base.css` | Palette and fonts only | +| `./css/component-support.css` | Palette, icon plugins, animations, layers and utilities the components need | +| `./css/themes/void.css` | Void theme for apps other than ComfyUI, including component support | | `./css/_palette.css` | Color variables | | `./css/fonts.css` | Font faces | | `./css/_deprecated-aliases.css` | Deprecated variable names kept for extensions; scheduled for removal | diff --git a/packages/design-system/src/components/common/NoResultsPlaceholder.vue b/packages/design-system/src/components/common/NoResultsPlaceholder.vue index ebefcec4ef4..83a2605a126 100644 --- a/packages/design-system/src/components/common/NoResultsPlaceholder.vue +++ b/packages/design-system/src/components/common/NoResultsPlaceholder.vue @@ -1,6 +1,6 @@