Update documentation and references from Wish Theme to KomTheme across various files, including README, installation guides, and component documentation. Add NuGet.Config to solution structure.
Release NuGet Packages / pack-and-push (release) Successful in 8m35s

This commit is contained in:
2026-05-25 19:27:29 +03:30
parent e1474c232b
commit 6a0e724eb0
25 changed files with 57 additions and 56 deletions
+14 -14
View File
@@ -1,34 +1,34 @@
# SufiBlazor Layout Components Review vs Wish Theme
# SufiBlazor Layout Components Review vs KomTheme
## Summary
The **Wish theme uses its own layout components** (`WishAppShell`, `WishDualSidebar`, `WishTopBar`, `WishSidebar`, `WishIconRail`, `WishExpandPanel`) in `SufiChain.SufiAbp.WishTheme.Blazor/Components/Layout/`. The SufiBlazor design system shell components (`SbAppShell`, `SbDualSidebar`, `SbTopBar`, `SbSidebar`, `SbIconRail`, `SbExpandPanel`) are **not used** in any application or in the Wish theme.
The **KomTheme uses its own layout components** (`KomAppShell`, `KomDualSidebar`, `KomTopBar`, `KomSidebar`, `KomIconRail`, `KomExpandPanel`) in `SufiChain.KomTheme.Blazor/Components/Layout/`. The SufiBlazor design system shell components (`SbAppShell`, `SbDualSidebar`, `SbTopBar`, `SbSidebar`, `SbIconRail`, `SbExpandPanel`) are **not used** in any application or in the KomTheme.
## Usage by Component
| Component | Used in Wish theme? | Used elsewhere? | Verdict |
| Component | Used in KomTheme? | Used elsewhere? | Verdict |
|-----------|---------------------|-----------------|---------|
| **SbContainer** | Yes `TopMenuLayout.razor` | SufiBlazorDemo | **KEEP** |
| **SbContainerMaxWidth** | Yes with SbContainer | SufiBlazorDemo | **KEEP** |
| **SbAppShell** | No | No (docs only) | **REMOVED** redundant; Wish uses WishAppShell |
| **SbAppShell** | No | No (docs only) | **REMOVED** redundant; Kom uses KomAppShell |
| **SbAppShellVariant** | No | No (not even used by SbAppShell) | **REMOVED** dead code |
| **SbDualSidebar** | No | No (docs only) | **REMOVED** redundant; Wish uses WishDualSidebar |
| **SbTopBar** | No | No (docs only) | **REMOVED** redundant; Wish uses WishTopBar |
| **SbSidebar** | No | No (docs only) | **REMOVED** redundant; Wish uses WishSidebar |
| **SbIconRail** | No | No (docs only) | **REMOVED** redundant; Wish uses WishIconRail |
| **SbExpandPanel** | No | No (docs only) | **REMOVED** redundant; Wish uses WishExpandPanel |
| **SbDualSidebar** | No | No (docs only) | **REMOVED** redundant; Kom uses KomDualSidebar |
| **SbTopBar** | No | No (docs only) | **REMOVED** redundant; Kom uses KomTopBar |
| **SbSidebar** | No | No (docs only) | **REMOVED** redundant; Kom uses KomSidebar |
| **SbIconRail** | No | No (docs only) | **REMOVED** redundant; Kom uses KomIconRail |
| **SbExpandPanel** | No | No (docs only) | **REMOVED** redundant; Kom uses KomExpandPanel |
| **SbStack** | Yes (class names in layouts) | Identity, FileManager, Audit, Feature, Setting modules | **KEEP** |
| **SbAlign, SbJustify, SbStackDirection** | Yes | Many modules | **KEEP** |
| **SbGrid, SbGridItem** | No | SufiBlazorDemo only | **KEEP** design system primitives |
| **SbSpacer** | No | SufiBlazorDemo only | **KEEP** design system primitive |
## Wish Theme Layouts
## KomTheme Layouts
- **DualSidebarLayout.razor** Uses `WishAppShell`, `WishDualSidebar`, `WishIconRail`, `WishExpandPanel`, `WishTopBar`.
- **SideMenuLayout.razor** Uses `WishAppShell`, `WishSidebar`, `WishTopBar`.
- **TopMenuLayout.razor** Uses `WishTopBar`, **SbContainer** (only Sb layout component used), `SbDrawer`, `SbNavMenu`, etc.
- **DualSidebarLayout.razor** Uses `KomAppShell`, `KomDualSidebar`, `KomIconRail`, `KomExpandPanel`, `KomTopBar`.
- **SideMenuLayout.razor** Uses `KomAppShell`, `KomSidebar`, `KomTopBar`.
- **TopMenuLayout.razor** Uses `KomTopBar`, **SbContainer** (only Sb layout component used), `SbDrawer`, `SbNavMenu`, etc.
## Conclusion
- **Keep:** SbContainer, SbContainerMaxWidth, SbStack, SbAlign, SbJustify, SbStackDirection, SbGrid, SbGridItem, SbSpacer (used by apps or by design-system demo).
- **Removed:** SbAppShell, SbAppShellVariant, SbDualSidebar, SbTopBar, SbSidebar, SbIconRail, SbExpandPanel unused and redundant with Wish theme components; removing them avoids confusion and mistaken use during feature development.
- **Removed:** SbAppShell, SbAppShellVariant, SbDualSidebar, SbTopBar, SbSidebar, SbIconRail, SbExpandPanel unused and redundant with KomTheme components; removing them avoids confusion and mistaken use during feature development.
+1 -1
View File
@@ -84,7 +84,7 @@ public enum SbContainerMaxWidth
### Page Layout
Use `SbContainer` inside your layout (e.g. Wish theme layouts use it for main content):
Use `SbContainer` inside your layout (e.g. KomTheme layouts use it for main content):
```razor
<SbContainer MaxWidth="SbContainerMaxWidth.Xl">
+1 -1
View File
@@ -93,7 +93,7 @@ public enum SbSpacerSize
### In Navigation Menu
Use `SbSpacer Grow="true"` inside a vertical stack to push items to the bottom (e.g. in Wish theme's `WishSidebar` or `WishIconRail`):
Use `SbSpacer Grow="true"` inside a vertical stack to push items to the bottom (e.g. in KomTheme's `KomSidebar` or `KomIconRail`):
```razor
<SbStack Direction="SbStackDirection.Column" Gap="0">
+1 -1
View File
@@ -123,7 +123,7 @@ public class SbBreadcrumbItem
### In Page Layout
Breadcrumbs are typically rendered in the layout's top bar (e.g. Wish theme's `WishTopBar`). Content area example:
Breadcrumbs are typically rendered in the layout's top bar (e.g. KomTheme's `KomTopBar`). Content area example:
```razor
<SbContainer>
+1 -1
View File
@@ -55,7 +55,7 @@ A navigation menu container component for organizing navigation items.
### Inside a layout sidebar
Use `SbNavMenu` inside the Wish theme's sidebar (e.g. `WishSidebar` or `WishExpandPanel`):
Use `SbNavMenu` inside the KomTheme's sidebar (e.g. `KomSidebar` or `KomExpandPanel`):
```razor
<SbNavMenu>
+1 -1
View File
@@ -122,7 +122,7 @@ A lightweight tooltip component that appears on hover or focus to provide additi
### Icon rail tooltips
In an icon rail (e.g. Wish theme's `WishIconRail`), wrap nav items with `SbTooltip` and `Placement="SbPlacement.End"` so the tooltip appears to the right:
In an icon rail (e.g. KomTheme's `KomIconRail`), wrap nav items with `SbTooltip` and `Placement="SbPlacement.End"` so the tooltip appears to the right:
```razor
<SbStack Direction="SbStackDirection.Column" Gap="1">
+1 -1
View File
@@ -115,7 +115,7 @@ Place `SbThemeProvider` at the root of your application:
### Full Application Setup
App shell and top bar are provided by the **Wish theme** (e.g. `WishAppShell`, `WishTopBar`). For a minimal layout using only SufiBlazor primitives:
App shell and top bar are provided by the **KomTheme** (e.g. `KomAppShell`, `KomTopBar`). For a minimal layout using only SufiBlazor primitives:
```razor
@* Minimal layout using design system only *@