v3.30.1

changelog.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 2026-01-04 - 3.30.1 - fix(dees-statsgrid)
+refine spacing, sizing, and colors in dees-statsgrid for a tighter, more compact appearance
+
+- Reduce global spacing and sizing variables (grid-gap 16→12, tile-padding 24→16, header-spacing 16→12, content-min-height 48→40, description-spacing 12→8, border-radius 8→6).
+- Adjust typographic scale (value-font-size 30→26, unit-font-size 16→14, label-font-size 13→12, title-font-size 14→13).
+- Switch color tokens to neutral hex values and tighten hover/box-shadow (tile border and backgrounds updated from HSL to hex, hover bg to #fafafa/#0d0d0d, border-color and shadow reduced).
+- Downsize graphical elements: gauge and SVG dimensions (width 140→120, height 80→70), stroke-widths 8→6, radius 48→40.
+- Slim down percentage bar and trend visuals (percentage bar height 8→6, border-radius 4→3, trend stroke-width 2→1.5, trend fill moved to RGBA).
+- No functional or API changes — purely visual/CSS and SVG adjustments.
+
+## 2026-01-03 - 3.30.0 - feat(appui)
+add dees-appui-bottombar component with config, programmatic API, demo and docs
+
+- Adds a new dees-appui-bottombar web component (ts_web/elements/00group-appui/dees-appui-bottombar/) implementing widget and action management (add/update/remove/get/clear).
+- Introduces bottom bar types and API in ts_web/elements/interfaces/appconfig.ts (IBottomBarWidget, IBottomBarAction, IBottomBarConfig, IBottomBarAPI) and extends the app config/type to include bottomBar and bottomBar APIs.
+- Integrates the bottom bar into dees-appui: imports and registers component, renders conditionally, exposes bottomBar proxy API, visibility controls (set/getBottomBarVisible), and wires initial config to populate widgets/actions.
+- Updates layout/styles (reduces main grid height to account for 24px fixed bottom bar and adds bottombar-hidden attribute handling) and exports component from the appui index.
+- Adds interactive demos (dees-appui-bottombar.demo.ts and integration demo) and documents usage and API in readme.hints.md.
+
+## 2026-01-03 - 3.29.3 - fix(elements/appui)
+prevent scroll chaining on app UI components by adding overscroll-behavior: contain
+
+- Added CSS overscroll-behavior: contain to activity log, main menu, secondary menu, profile dropdown, and tabs components to prevent scroll chaining and unintended body scrolling on touch/trackpad.
+- Styling-only change; no public API or behavioral changes beyond scroll handling.
+- Bump patch version from 3.29.2 to 3.29.3.
+
+## 2026-01-03 - 3.29.2 - fix(dees-appui)
+set min-height: 0 on .maingrid > dees-appui-maincontent to prevent layout overflow in flex container
+
+- Added min-height: 0 to .maingrid > dees-appui-maincontent in ts_web/elements/00group-appui/dees-appui/dees-appui.ts to prevent unwanted growth/overflow when used inside a flex container.
+- Pure CSS/layout fix — no API or behavior changes to components.
+
+## 2026-01-03 - 3.29.1 - fix(dees-appui)
+prevent main grid overflow by adding overflow:hidden; and add Playwright scroll containment screenshots
+
+- Add overflow: hidden to .maingrid in ts_web/elements/00group-appui/dees-appui/dees-appui.ts to prevent content from escaping during grid-template-columns transitions.
+- Add Playwright artifacts: .playwright-mcp/after-scroll.png and .playwright-mcp/scroll-containment-check.png (screenshots for scroll containment testing).
+
+## 2026-01-03 - 3.29.0 - feat(docs)
+add documentation for new input components, activity log features, theming, and expand DeesAppui docs
+
+- Updated top-level README to reflect component count increase (75+ → 80+) and added many new component docs
+- Added documentation and examples for DeesInputList (sortable list input) and DeesInputProfilepicture (cropping, upload, processing)
+- Introduced DeesTheme documentation with usage examples and CSS custom property overrides
+- Expanded DeesAppui readme with architecture overview, activity log panel docs, activity entry types, and navigation/secondary menu guidance
+- Documented activity log APIs and controls (activityLog.add, addMany, clear, getEntries, filter, search) and new control API helpers (setActivityLogVisible, toggleActivityLog, getActivityLogVisible)
+- Updated Appbar examples to include activity log toggle properties (.showActivityLogToggle, .activityLogCount, .activityLogActive) and @activity-toggle event
+- Added interface docs (IViewDefinition, IActivityEntry) and updated menu/secondary menu type references
+- Changes are documentation-focused (README/element readmes); no source code logic changes shown in this diff
+
 ## 2026-01-03 - 3.28.1 - fix(appui)
 adjust layout and spacing in app UI components: fix activity log overflow, contain main content overscroll, and refine secondary menu padding/transition
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "3.28.1",
+  "version": "3.30.1",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",

readme.hints.md

@@ -800,4 +800,114 @@ html`
 - **External Router Support**: Integrate with Angular Router or other frameworks
 - **State Persistence**: Save/restore collapsed menus, selections, and current view
 - **View-specific Menus**: Each view can define its own secondary menu and tabs
-- **Full Backward Compatibility**: Existing code continues to work
+- **Full Backward Compatibility**: Existing code continues to work
+
+## AppUI Bottom Bar (2026-01-03)
+
+Added a new `dees-appui-bottombar` component similar to `dees-workspace-bottombar`, providing a 24px fixed-height status bar at the bottom of the app shell.
+
+### Features:
+- **Generic status widgets**: Configurable widgets with icon, label, status colors, loading spinner
+- **App-specific actions**: Quick action buttons with icons and tooltips
+- **Always visible**: Fixed 24px height at the bottom of the app
+- **Status colors**: idle, active (blue), success (green), warning (yellow), error (red)
+- **Context menus**: Widgets can have right-click context menus
+
+### New Interfaces (in `interfaces/appconfig.ts`):
+
+```typescript
+interface IBottomBarWidget {
+  id: string;
+  iconName?: string;
+  label?: string;
+  status?: 'idle' | 'active' | 'success' | 'warning' | 'error';
+  tooltip?: string;
+  loading?: boolean;
+  onClick?: () => void;
+  contextMenuItems?: IBottomBarContextMenuItem[];
+  position?: 'left' | 'right';
+  order?: number;
+}
+
+interface IBottomBarAction {
+  id: string;
+  iconName: string;
+  tooltip?: string;
+  onClick: () => void | Promise<void>;
+  disabled?: boolean;
+  position?: 'left' | 'right';
+}
+
+interface IBottomBarConfig {
+  visible?: boolean;
+  widgets?: IBottomBarWidget[];
+  actions?: IBottomBarAction[];
+}
+```
+
+### Usage via configure():
+
+```typescript
+const config: IAppConfig = {
+  // ... other config
+  bottomBar: {
+    visible: true,
+    widgets: [
+      {
+        id: 'status',
+        iconName: 'lucide:activity',
+        label: 'System Online',
+        status: 'success',
+        tooltip: 'All systems operational',
+        onClick: () => console.log('Status clicked'),
+      },
+      {
+        id: 'notifications',
+        iconName: 'lucide:bell',
+        label: '3 notifications',
+        status: 'warning',
+        position: 'left',
+      },
+      {
+        id: 'version',
+        iconName: 'lucide:gitBranch',
+        label: 'v1.2.3',
+        position: 'right',
+      },
+    ],
+    actions: [
+      {
+        id: 'terminal',
+        iconName: 'lucide:terminal',
+        tooltip: 'Open Terminal',
+        position: 'right',
+        onClick: () => console.log('Terminal clicked'),
+      },
+    ],
+  },
+};
+```
+
+### Programmatic API:
+
+```typescript
+// Add/update/remove widgets
+appui.bottomBar.addWidget({ id: 'status', ... });
+appui.bottomBar.updateWidget('status', { status: 'error', label: 'Error!' });
+appui.bottomBar.removeWidget('status');
+appui.bottomBar.clearWidgets();
+
+// Add/remove actions
+appui.bottomBar.addAction({ id: 'refresh', iconName: 'lucide:refreshCw', ... });
+appui.bottomBar.removeAction('refresh');
+appui.bottomBar.clearActions();
+
+// Visibility control
+appui.setBottomBarVisible(false);
+appui.getBottomBarVisible();
+```
+
+### Files:
+- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.ts` - Main component
+- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.demo.ts` - Demo
+- `ts_web/elements/interfaces/appconfig.ts` - New interfaces added

readme.md

@@ -1,6 +1,6 @@
 # @design.estate/dees-catalog
 
-A comprehensive web components library built with TypeScript and LitElement, providing **75+ UI components** for building modern web applications with consistent design and behavior. 🚀
+A comprehensive web components library built with TypeScript and LitElement, providing **80+ production-ready UI components** for building modern web applications with consistent design and behavior. 🚀
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 [![LitElement](https://img.shields.io/badge/LitElement-4.0+-orange.svg)](https://lit.dev/)
@@ -53,13 +53,14 @@ For developers working on this library, please refer to the [UI Components Playb
 | Category | Components |
 |----------|------------|
 | **Core UI** | [`DeesButton`](#deesbutton), [`DeesButtonExit`](#deesbuttonexit), [`DeesButtonGroup`](#deesbuttongroup), [`DeesBadge`](#deesbadge), [`DeesChips`](#deeschips), [`DeesHeading`](#deesheading), [`DeesHint`](#deeshint), [`DeesIcon`](#deesicon), [`DeesLabel`](#deeslabel), [`DeesPanel`](#deespanel), [`DeesSearchbar`](#deessearchbar), [`DeesSpinner`](#deesspinner), [`DeesToast`](#deestoast), [`DeesWindowcontrols`](#deeswindowcontrols) |
-| **Forms** | [`DeesForm`](#deesform), [`DeesInputText`](#deesinputtext), [`DeesInputCheckbox`](#deesinputcheckbox), [`DeesInputDropdown`](#deesinputdropdown), [`DeesInputRadiogroup`](#deesinputradiogroup), [`DeesInputFileupload`](#deesinputfileupload), [`DeesInputIban`](#deesinputiban), [`DeesInputPhone`](#deesinputphone), [`DeesInputQuantitySelector`](#deesinputquantityselector), [`DeesInputMultitoggle`](#deesinputmultitoggle), [`DeesInputTags`](#deesinputtags), [`DeesInputTypelist`](#deesinputtypelist), [`DeesInputRichtext`](#deesinputrichtext), [`DeesInputWysiwyg`](#deesinputwysiwyg), [`DeesInputDatepicker`](#deesinputdatepicker), [`DeesInputSearchselect`](#deesinputsearchselect), [`DeesFormSubmit`](#deesformsubmit) |
+| **Forms** | [`DeesForm`](#deesform), [`DeesInputText`](#deesinputtext), [`DeesInputCheckbox`](#deesinputcheckbox), [`DeesInputDropdown`](#deesinputdropdown), [`DeesInputRadiogroup`](#deesinputradiogroup), [`DeesInputFileupload`](#deesinputfileupload), [`DeesInputIban`](#deesinputiban), [`DeesInputPhone`](#deesinputphone), [`DeesInputQuantitySelector`](#deesinputquantityselector), [`DeesInputMultitoggle`](#deesinputmultitoggle), [`DeesInputTags`](#deesinputtags), [`DeesInputTypelist`](#deesinputtypelist), [`DeesInputList`](#deesinputlist), [`DeesInputProfilepicture`](#deesinputprofilepicture), [`DeesInputRichtext`](#deesinputrichtext), [`DeesInputWysiwyg`](#deesinputwysiwyg), [`DeesInputDatepicker`](#deesinputdatepicker), [`DeesInputSearchselect`](#deesinputsearchselect), [`DeesFormSubmit`](#deesformsubmit) |
 | **Layout** | [`DeesAppui`](#deesappui), [`DeesAppuiMainmenu`](#deesappuimainmenu), [`DeesAppuiSecondarymenu`](#deesappuisecondarymenu), [`DeesAppuiMaincontent`](#deesappuimaincontent), [`DeesAppuiAppbar`](#deesappuiappbar), [`DeesAppuiActivitylog`](#deesappuiactivitylog), [`DeesAppuiProfiledropdown`](#deesappuiprofiledropdown), [`DeesAppuiTabs`](#deesappuitabs), [`DeesMobileNavigation`](#deesmobilenavigation), [`DeesDashboardGrid`](#deesdashboardgrid) |
 | **Data Display** | [`DeesTable`](#deestable), [`DeesDataviewCodebox`](#deesdataviewcodebox), [`DeesDataviewStatusobject`](#deesdataviewstatusobject), [`DeesPdf`](#deespdf), [`DeesStatsGrid`](#deesstatsgrid), [`DeesPagination`](#deespagination) |
 | **Visualization** | [`DeesChartArea`](#deeschartarea), [`DeesChartLog`](#deeschartlog) |
 | **Dialogs & Overlays** | [`DeesModal`](#deesmodal), [`DeesContextmenu`](#deescontextmenu), [`DeesSpeechbubble`](#deesspeechbubble), [`DeesWindowlayer`](#deeswindowlayer) |
 | **Navigation** | [`DeesStepper`](#deesstepper), [`DeesProgressbar`](#deesprogressbar) |
 | **Development** | [`DeesEditor`](#deeseditor), [`DeesEditorMarkdown`](#deeseditormarkdown), [`DeesEditorMarkdownoutlet`](#deeseditormarkdownoutlet), [`DeesTerminal`](#deesterminal), [`DeesUpdater`](#deesupdater) |
+| **Theming** | [`DeesTheme`](#deestheme) |
 | **Auth & Utilities** | [`DeesSimpleAppdash`](#deessimpleappdash), [`DeesSimpleLogin`](#deessimplelogin) |
 | **Shopping** | [`DeesShoppingProductcard`](#deesshoppingproductcard) |
 
@@ -482,6 +483,62 @@ Dynamic list input for managing arrays of typed values.
 ></dees-input-typelist>
 ```
 
+#### `DeesInputList`
+Advanced list input with drag-and-drop reordering, inline editing, and validation.
+
+```typescript
+<dees-input-list
+  key="items"
+  label="List Items"
+  placeholder="Add new item..."
+  .value=${['Item 1', 'Item 2', 'Item 3']}
+  maxItems={10}            // Optional: maximum items
+  minItems={1}             // Optional: minimum items
+  allowDuplicates={false}  // Optional: allow duplicate values
+  sortable={true}          // Optional: enable drag-and-drop reordering
+  confirmDelete={true}     // Optional: confirm before deletion
+  @change=${handleListChange}
+></dees-input-list>
+```
+
+**Key Features:**
+- Add, edit, and remove items inline
+- Drag-and-drop reordering with visual feedback
+- Optional duplicate prevention
+- Min/max item constraints
+- Delete confirmation dialog
+- Full keyboard support
+- Form validation integration
+
+#### `DeesInputProfilepicture`
+Profile picture input with cropping, zoom, and image processing.
+
+```typescript
+<dees-input-profilepicture
+  key="avatar"
+  label="Profile Picture"
+  shape="round"           // Options: round, square
+  size={120}              // Display size in pixels
+  .value=${imageBase64}   // Base64 encoded image or URL
+  allowUpload={true}      // Enable upload button
+  allowDelete={true}      // Enable delete button
+  maxFileSize={5242880}   // Max file size in bytes (5MB)
+  .acceptedFormats=${['image/jpeg', 'image/png', 'image/webp']}
+  outputSize={800}        // Output resolution in pixels
+  outputQuality={0.95}    // JPEG quality (0-1)
+  @change=${handleAvatarChange}
+></dees-input-profilepicture>
+```
+
+**Key Features:**
+- Interactive cropping modal with zoom and pan
+- Drag-and-drop file upload
+- Round or square output shapes
+- Configurable output size and quality
+- File size and format validation
+- Delete functionality
+- Preview on hover
+
 #### `DeesInputDatepicker`
 Date and time picker component with calendar interface and manual typing support.
 
@@ -661,6 +718,7 @@ class MyApp extends DeesElement {
 - **Hash-based Routing**: Automatic URL synchronization with view navigation
 - **RxJS Observables**: `viewChanged$` and `viewLifecycle$` for reactive programming
 - **TypeScript-first**: Typed `IViewActivationContext` passed to views on activation
+- **Activity Log Toggle**: Built-in appbar button to show/hide activity panel with entry count badge
 
 **Programmatic APIs include:**
 - `navigateToView(viewId, params?)` - Navigate between views
@@ -670,6 +728,7 @@ class MyApp extends DeesElement {
 - `setSecondaryMenu()`, `setSecondaryMenuCollapsed()`, `setSecondaryMenuVisible()` - Control secondary menu
 - `setContentTabs()`, `setContentTabsVisible()` - Control view-specific UI
 - `activityLog.add()`, `activityLog.addMany()`, `activityLog.clear()` - Manage activity entries
+- `setActivityLogVisible()`, `toggleActivityLog()`, `getActivityLogVisible()` - Control activity panel
 
 **View Visibility Control:**
 ```typescript
@@ -740,7 +799,7 @@ Main content area with tab management support.
 ```
 
 #### `DeesAppuiAppbar`
-Professional application bar component with hierarchical menus, breadcrumb navigation, and user account management.
+Professional application bar component with hierarchical menus, breadcrumb navigation, user account management, and activity log toggle.
 
 ```typescript
 <dees-appui-appbar
@@ -775,6 +834,9 @@ Professional application bar component with hierarchical menus, breadcrumb navig
   .breadcrumbs=${'Project > src > components'}
   .showWindowControls=${true}
   .showSearch=${true}
+  .showActivityLogToggle=${true}
+  .activityLogCount=${5}
+  .activityLogActive=${false}
   .user=${{
     name: 'John Doe',
     avatar: '/path/to/avatar.jpg',
@@ -782,6 +844,7 @@ Professional application bar component with hierarchical menus, breadcrumb navig
   }}
   @menu-select=${(e) => handleMenuSelect(e.detail.item)}
   @breadcrumb-navigate=${(e) => handleBreadcrumbClick(e.detail)}
+  @activity-toggle=${() => handleActivityToggle()}
 ></dees-appui-appbar>
 ```
 
@@ -789,9 +852,40 @@ Professional application bar component with hierarchical menus, breadcrumb navig
 - **Hierarchical Menu System** - Top-level menus with dropdown submenus, icons, and keyboard shortcuts
 - **Keyboard Navigation** - Full keyboard support (Tab, Arrow keys, Enter, Escape)
 - **Breadcrumb Navigation** - Customizable breadcrumb trail with click events
-- **User Account Section** - Avatar with status indicator
+- **User Account Section** - Avatar with status indicator and profile dropdown
+- **Activity Log Toggle** - Button with badge count to show/hide activity panel
 - **Accessibility** - Full ARIA support with menubar roles
 
+#### `DeesAppuiActivitylog`
+Real-time activity log panel for displaying user actions and system events.
+
+```typescript
+<dees-appui-activitylog></dees-appui-activitylog>
+
+// Programmatic API
+activityLog.add({
+  type: 'update',        // Options: login, logout, view, create, update, delete, custom
+  user: 'John Doe',
+  message: 'Updated project settings',
+  iconName: 'lucide:settings'  // Optional: custom icon
+});
+
+activityLog.addMany(entries);  // Add multiple entries
+activityLog.clear();           // Clear all entries
+activityLog.getEntries();      // Get all entries
+activityLog.filter({ user: 'John' });  // Filter by user/type
+activityLog.search('settings');        // Search by message
+```
+
+**Key Features:**
+- Stacked entry layout with icon, user, timestamp, and message
+- Date grouping (Today, Yesterday, etc.)
+- Search and filter functionality
+- Context menu for entry actions
+- Live streaming indicator
+- Animated slide-in/out panel
+- Theme-aware styling
+
 #### `DeesAppuiTabs`
 Reusable tab component with horizontal/vertical layout support.
 
@@ -1089,6 +1183,40 @@ Progress indicator component for tracking completion status.
 
 ---
 
+### Theming Components
+
+#### `DeesTheme`
+Theme provider component that wraps children and provides CSS custom properties for consistent theming.
+
+```typescript
+// Basic usage - wrap your app
+<dees-theme>
+  <my-app></my-app>
+</dees-theme>
+
+// With custom overrides
+<dees-theme
+  .customColors=${{
+    primary: '#007bff',
+    success: '#28a745'
+  }}
+  .customSpacing=${{
+    lg: '24px',
+    xl: '32px'
+  }}
+>
+  <my-section></my-section>
+</dees-theme>
+```
+
+**Key Features:**
+- Provides CSS custom properties for colors, spacing, radius, shadows, and transitions
+- Can be nested for section-specific theming
+- Works with dark/light mode
+- Overrides cascade to all child components
+
+---
+
 ### Development Components
 
 #### `DeesEditor`
@@ -1241,6 +1369,29 @@ interface IMenuGroup {
   collapsed?: boolean;
   iconName?: string;
 }
+
+// View definition for app navigation
+interface IViewDefinition {
+  id: string;
+  name: string;
+  iconName?: string;
+  content: string | HTMLElement | (() => TemplateResult);
+  secondaryMenu?: ISecondaryMenuGroup[];
+  contentTabs?: IMenuItem[];
+  route?: string;
+  badge?: string | number;
+}
+
+// Activity log entry
+interface IActivityEntry {
+  id?: string;
+  timestamp?: Date;
+  type: 'login' | 'logout' | 'view' | 'create' | 'update' | 'delete' | 'custom';
+  user: string;
+  message: string;
+  iconName?: string;
+  data?: Record<string, unknown>;
+}
 ```
 
 ---

ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-catalog',
-  version: '3.28.1',
+  version: '3.30.1',
   description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 }

ts_web/elements/00group-appui/dees-appui-activitylog/dees-appui-activitylog.ts

@@ -122,6 +122,7 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
         width: 100%;
         padding: 8px 0;
         overflow-y: auto;
+        overscroll-behavior: contain;
         scrollbar-width: thin;
         scrollbar-color: ${cssManager.bdTheme('#d4d4d4', '#333333')} transparent;
       }

ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.demo.ts

@@ -0,0 +1,210 @@
+import { html } from '@design.estate/dees-element';
+import type { DeesAppuiBottombar } from './dees-appui-bottombar.js';
+import '@design.estate/dees-wcctools/demotools';
+
+export const demoFunc = () => {
+  return html`
+    <dees-demowrapper>
+      <style>
+        .demo-container {
+          display: flex;
+          flex-direction: column;
+          gap: 24px;
+          padding: 24px;
+          background: #1a1a1a;
+        }
+
+        .demo-section {
+          display: flex;
+          flex-direction: column;
+          gap: 8px;
+        }
+
+        .demo-label {
+          font-size: 12px;
+          color: #737373;
+          font-family: 'Geist Sans', sans-serif;
+        }
+
+        .demo-bottombar-wrapper {
+          border: 1px solid hsl(0 0% 20%);
+          border-radius: 4px;
+          overflow: hidden;
+        }
+      </style>
+      <div class="demo-container">
+        <div class="demo-section">
+          <div class="demo-label">Bottom bar with status widgets and actions</div>
+          <div class="demo-bottombar-wrapper">
+            <dees-appui-bottombar
+              id="demo-bottombar"
+            ></dees-appui-bottombar>
+          </div>
+        </div>
+
+        <div class="demo-section">
+          <div class="demo-label">Controls</div>
+          <div style="display: flex; gap: 8px; flex-wrap: wrap;">
+            <button onclick="addSuccessWidget()">Add Success Widget</button>
+            <button onclick="addWarningWidget()">Add Warning Widget</button>
+            <button onclick="addErrorWidget()">Add Error Widget</button>
+            <button onclick="addLoadingWidget()">Add Loading Widget</button>
+            <button onclick="addRightWidget()">Add Right Widget</button>
+            <button onclick="addAction()">Add Action</button>
+            <button onclick="clearAll()">Clear All</button>
+          </div>
+        </div>
+      </div>
+      <script type="module">
+        const bottombar = document.getElementById('demo-bottombar');
+
+        // Wait for component to initialize
+        await bottombar.updateComplete;
+
+        // Add initial widgets
+        bottombar.addWidget({
+          id: 'status',
+          iconName: 'lucide:activity',
+          label: 'System Online',
+          status: 'success',
+          tooltip: 'All systems operational',
+          onClick: () => console.log('Status clicked'),
+          contextMenuItems: [
+            { name: 'View Details', iconName: 'lucide:info', action: () => alert('System details') },
+            { divider: true },
+            { name: 'Refresh Status', iconName: 'lucide:refreshCw', action: () => alert('Refreshing...') },
+          ],
+        });
+
+        bottombar.addWidget({
+          id: 'notifications',
+          iconName: 'lucide:bell',
+          label: '3 notifications',
+          status: 'warning',
+          tooltip: 'You have unread notifications',
+          onClick: () => console.log('Notifications clicked'),
+        });
+
+        bottombar.addWidget({
+          id: 'version',
+          iconName: 'lucide:gitBranch',
+          label: 'v1.2.3',
+          tooltip: 'Current version',
+          position: 'right',
+          onClick: () => console.log('Version clicked'),
+        });
+
+        // Add initial actions
+        bottombar.addAction({
+          id: 'settings',
+          iconName: 'lucide:settings',
+          tooltip: 'Settings',
+          position: 'right',
+          onClick: () => alert('Settings clicked'),
+        });
+
+        bottombar.addAction({
+          id: 'help',
+          iconName: 'lucide:helpCircle',
+          tooltip: 'Help',
+          position: 'right',
+          onClick: () => alert('Help clicked'),
+        });
+
+        // Demo control functions
+        let widgetCounter = 0;
+        let actionCounter = 0;
+
+        window.addSuccessWidget = () => {
+          widgetCounter++;
+          bottombar.addWidget({
+            id: 'success-' + widgetCounter,
+            iconName: 'lucide:checkCircle',
+            label: 'Success ' + widgetCounter,
+            status: 'success',
+            tooltip: 'Success widget',
+            onClick: () => bottombar.removeWidget('success-' + widgetCounter),
+          });
+        };
+
+        window.addWarningWidget = () => {
+          widgetCounter++;
+          bottombar.addWidget({
+            id: 'warning-' + widgetCounter,
+            iconName: 'lucide:alertTriangle',
+            label: 'Warning ' + widgetCounter,
+            status: 'warning',
+            tooltip: 'Warning widget',
+            onClick: () => bottombar.removeWidget('warning-' + widgetCounter),
+          });
+        };
+
+        window.addErrorWidget = () => {
+          widgetCounter++;
+          bottombar.addWidget({
+            id: 'error-' + widgetCounter,
+            iconName: 'lucide:xCircle',
+            label: 'Error ' + widgetCounter,
+            status: 'error',
+            tooltip: 'Error widget',
+            onClick: () => bottombar.removeWidget('error-' + widgetCounter),
+          });
+        };
+
+        window.addLoadingWidget = () => {
+          widgetCounter++;
+          const id = 'loading-' + widgetCounter;
+          bottombar.addWidget({
+            id: id,
+            iconName: 'lucide:loader2',
+            label: 'Loading...',
+            status: 'active',
+            loading: true,
+            tooltip: 'Loading in progress',
+          });
+
+          // Simulate completion after 3 seconds
+          setTimeout(() => {
+            bottombar.updateWidget(id, {
+              iconName: 'lucide:check',
+              label: 'Done!',
+              status: 'success',
+              loading: false,
+            });
+          }, 3000);
+        };
+
+        window.addRightWidget = () => {
+          widgetCounter++;
+          bottombar.addWidget({
+            id: 'right-' + widgetCounter,
+            iconName: 'lucide:info',
+            label: 'Right ' + widgetCounter,
+            position: 'right',
+            onClick: () => bottombar.removeWidget('right-' + widgetCounter),
+          });
+        };
+
+        window.addAction = () => {
+          actionCounter++;
+          bottombar.addAction({
+            id: 'action-' + actionCounter,
+            iconName: 'lucide:zap',
+            tooltip: 'Action ' + actionCounter,
+            onClick: () => {
+              alert('Action ' + actionCounter + ' clicked');
+              bottombar.removeAction('action-' + actionCounter);
+            },
+          });
+        };
+
+        window.clearAll = () => {
+          bottombar.clearWidgets();
+          bottombar.clearActions();
+          widgetCounter = 0;
+          actionCounter = 0;
+        };
+      </script>
+    </dees-demowrapper>
+  `;
+};

ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.ts

@@ -0,0 +1,314 @@
+import {
+  DeesElement,
+  type TemplateResult,
+  customElement,
+  html,
+  css,
+  cssManager,
+  state,
+} from '@design.estate/dees-element';
+import { themeDefaultStyles } from '../../00theme.js';
+import '../../dees-icon/dees-icon.js';
+import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
+import type {
+  IBottomBarWidget,
+  IBottomBarAction,
+  IBottomBarAPI,
+} from '../../interfaces/appconfig.js';
+import { demoFunc } from './dees-appui-bottombar.demo.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-appui-bottombar': DeesAppuiBottombar;
+  }
+}
+
+@customElement('dees-appui-bottombar')
+export class DeesAppuiBottombar extends DeesElement implements IBottomBarAPI {
+  public static demo = demoFunc;
+
+  // INSTANCE PROPERTIES
+  @state()
+  accessor widgets: IBottomBarWidget[] = [];
+
+  @state()
+  accessor actions: IBottomBarAction[] = [];
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        height: 24px;
+        flex-shrink: 0;
+        user-select: none;
+      }
+
+      .bottom-bar {
+        height: 24px;
+        display: flex;
+        align-items: center;
+        padding: 0 8px;
+        gap: 4px;
+        background: ${cssManager.bdTheme('hsl(0 0% 94%)', 'hsl(0 0% 6%)')};
+        border-top: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
+        font-size: 11px;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+
+      .widget {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        padding: 2px 6px;
+        border-radius: 3px;
+        cursor: pointer;
+        transition: background 0.15s ease, color 0.15s ease;
+        white-space: nowrap;
+      }
+
+      .widget:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 80%)')};
+      }
+
+      .widget dees-icon {
+        flex-shrink: 0;
+      }
+
+      .widget-separator {
+        width: 1px;
+        height: 14px;
+        background: ${cssManager.bdTheme('hsl(0 0% 80%)', 'hsl(0 0% 20%)')};
+        margin: 0 4px;
+      }
+
+      /* Status colors matching dees-workspace-bottombar */
+      .widget.active {
+        color: ${cssManager.bdTheme('hsl(210 100% 45%)', 'hsl(210 100% 60%)')};
+      }
+
+      .widget.success {
+        color: ${cssManager.bdTheme('hsl(142 70% 35%)', 'hsl(142 70% 50%)')};
+      }
+
+      .widget.warning {
+        color: ${cssManager.bdTheme('hsl(38 92% 45%)', 'hsl(38 92% 55%)')};
+      }
+
+      .widget.error {
+        color: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 60%)')};
+      }
+
+      @keyframes spin {
+        from { transform: rotate(0deg); }
+        to { transform: rotate(360deg); }
+      }
+
+      .spinning {
+        animation: spin 1s linear infinite;
+      }
+
+      .spacer {
+        flex: 1;
+      }
+
+      .action-button {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        width: 20px;
+        height: 20px;
+        border-radius: 3px;
+        cursor: pointer;
+        transition: background 0.15s ease;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+
+      .action-button:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 80%)')};
+      }
+
+      .action-button.disabled {
+        opacity: 0.5;
+        cursor: not-allowed;
+      }
+
+      .action-button.disabled:hover {
+        background: transparent;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    const leftWidgets = this.widgets
+      .filter(w => w.position !== 'right')
+      .sort((a, b) => (a.order || 0) - (b.order || 0));
+
+    const rightWidgets = this.widgets
+      .filter(w => w.position === 'right')
+      .sort((a, b) => (a.order || 0) - (b.order || 0));
+
+    const leftActions = this.actions.filter(a => a.position === 'left');
+    const rightActions = this.actions.filter(a => a.position !== 'left');
+
+    return html`
+      <div class="bottom-bar">
+        <!-- Left actions -->
+        ${leftActions.map(action => this.renderAction(action))}
+
+        <!-- Left widgets -->
+        ${leftWidgets.map((widget, index) => html`
+          ${index > 0 || leftActions.length > 0 ? html`<div class="widget-separator"></div>` : ''}
+          ${this.renderWidget(widget)}
+        `)}
+
+        <div class="spacer"></div>
+
+        <!-- Right widgets -->
+        ${rightWidgets.map((widget, index) => html`
+          ${this.renderWidget(widget)}
+          ${index < rightWidgets.length - 1 || rightActions.length > 0 ? html`<div class="widget-separator"></div>` : ''}
+        `)}
+
+        <!-- Right actions -->
+        ${rightActions.map(action => this.renderAction(action))}
+      </div>
+    `;
+  }
+
+  private renderWidget(widget: IBottomBarWidget): TemplateResult {
+    const statusClass = widget.status && widget.status !== 'idle' ? widget.status : '';
+    const iconName = widget.iconName
+      ? (widget.iconName.startsWith('lucide:') ? widget.iconName : `lucide:${widget.iconName}`)
+      : '';
+
+    return html`
+      <div
+        class="widget ${statusClass}"
+        title="${widget.tooltip || ''}"
+        @click=${() => widget.onClick?.()}
+        @contextmenu=${(e: MouseEvent) => this.handleWidgetContextMenu(e, widget)}
+      >
+        ${iconName ? html`
+          <dees-icon
+            .icon=${iconName}
+            iconSize="12"
+            class="${widget.loading ? 'spinning' : ''}"
+          ></dees-icon>
+        ` : ''}
+        ${widget.label ? html`<span>${widget.label}</span>` : ''}
+      </div>
+    `;
+  }
+
+  private renderAction(action: IBottomBarAction): TemplateResult {
+    const iconName = action.iconName.startsWith('lucide:')
+      ? action.iconName
+      : `lucide:${action.iconName}`;
+
+    return html`
+      <div
+        class="action-button ${action.disabled ? 'disabled' : ''}"
+        title="${action.tooltip || ''}"
+        @click=${() => !action.disabled && action.onClick?.()}
+      >
+        <dees-icon
+          .icon=${iconName}
+          iconSize="12"
+        ></dees-icon>
+      </div>
+    `;
+  }
+
+  private async handleWidgetContextMenu(e: MouseEvent, widget: IBottomBarWidget): Promise<void> {
+    if (!widget.contextMenuItems || widget.contextMenuItems.length === 0) return;
+
+    e.preventDefault();
+
+    const menuItems: Parameters<typeof DeesContextmenu.openContextMenuWithOptions>[1] = [];
+
+    for (const item of widget.contextMenuItems) {
+      if (item.divider) {
+        menuItems.push({ divider: true });
+      } else {
+        menuItems.push({
+          name: item.name,
+          iconName: item.iconName,
+          action: async () => { await item.action(); },
+          disabled: item.disabled,
+        });
+      }
+    }
+
+    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
+  }
+
+  // ==========================================
+  // API METHODS (implements IBottomBarAPI)
+  // ==========================================
+
+  /**
+   * Add a widget to the bottom bar
+   */
+  public addWidget(widget: IBottomBarWidget): void {
+    // Remove existing widget with same ID if present
+    this.widgets = this.widgets.filter(w => w.id !== widget.id);
+    this.widgets = [...this.widgets, widget];
+  }
+
+  /**
+   * Update an existing widget by ID
+   */
+  public updateWidget(id: string, update: Partial<IBottomBarWidget>): void {
+    this.widgets = this.widgets.map(w =>
+      w.id === id ? { ...w, ...update } : w
+    );
+  }
+
+  /**
+   * Remove a widget by ID
+   */
+  public removeWidget(id: string): void {
+    this.widgets = this.widgets.filter(w => w.id !== id);
+  }
+
+  /**
+   * Get a widget by ID
+   */
+  public getWidget(id: string): IBottomBarWidget | undefined {
+    return this.widgets.find(w => w.id === id);
+  }
+
+  /**
+   * Clear all widgets
+   */
+  public clearWidgets(): void {
+    this.widgets = [];
+  }
+
+  /**
+   * Add an action button
+   */
+  public addAction(action: IBottomBarAction): void {
+    this.actions = this.actions.filter(a => a.id !== action.id);
+    this.actions = [...this.actions, action];
+  }
+
+  /**
+   * Remove an action by ID
+   */
+  public removeAction(id: string): void {
+    this.actions = this.actions.filter(a => a.id !== id);
+  }
+
+  /**
+   * Clear all actions
+   */
+  public clearActions(): void {
+    this.actions = [];
+  }
+}

ts_web/elements/00group-appui/dees-appui-bottombar/index.ts

@@ -0,0 +1 @@
+export * from './dees-appui-bottombar.js';

ts_web/elements/00group-appui/dees-appui-mainmenu/dees-appui-mainmenu.ts

@@ -164,6 +164,7 @@ export class DeesAppuiMainmenu extends DeesElement {
         flex: 1;
         overflow-y: auto;
         overflow-x: hidden;
+        overscroll-behavior: contain;
         padding: 8px 0;
       }
 

ts_web/elements/00group-appui/dees-appui-profiledropdown/dees-appui-profiledropdown.ts

@@ -285,6 +285,7 @@ export class DeesAppuiProfileDropdown extends DeesElement {
           max-width: calc(100vw - 32px);
           max-height: calc(100vh - 32px);
           overflow-y: auto;
+          overscroll-behavior: contain;
         }
 
         :host([isopen]) .dropdown {

ts_web/elements/00group-appui/dees-appui-secondarymenu/dees-appui-secondarymenu.ts

@@ -201,6 +201,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         flex: 1;
         overflow-y: auto;
         overflow-x: hidden;
+        overscroll-behavior: contain;
         padding: 8px 0;
       }
 

ts_web/elements/00group-appui/dees-appui-tabs/dees-appui-tabs.ts

@@ -116,6 +116,7 @@ export class DeesAppuiTabs extends DeesElement {
         font-size: 14px;
         overflow-x: auto;
         overflow-y: hidden;
+        overscroll-behavior: contain;
         scrollbar-width: thin;
         scrollbar-color: transparent transparent;
         height: 100%;

ts_web/elements/00group-appui/dees-appui/dees-appui.demo.ts

@@ -663,6 +663,44 @@ export const demoFunc = () => {
 
     defaultView: 'dashboard',
 
+    bottomBar: {
+      visible: true,
+      widgets: [
+        {
+          id: 'status',
+          iconName: 'lucide:activity',
+          label: 'System Online',
+          status: 'success',
+          tooltip: 'All systems operational',
+          onClick: () => console.log('Status clicked'),
+        },
+        {
+          id: 'notifications',
+          iconName: 'lucide:bell',
+          label: '3 notifications',
+          status: 'warning',
+          tooltip: 'You have unread notifications',
+          onClick: () => console.log('Notifications clicked'),
+        },
+        {
+          id: 'version',
+          iconName: 'lucide:gitBranch',
+          label: 'v1.2.3',
+          position: 'right',
+          tooltip: 'Current version',
+        },
+      ],
+      actions: [
+        {
+          id: 'terminal',
+          iconName: 'lucide:terminal',
+          tooltip: 'Open Terminal',
+          position: 'right',
+          onClick: () => console.log('Terminal clicked'),
+        },
+      ],
+    },
+
     onViewChange: (viewId, view) => {
       console.log(`View changed to: ${viewId} (${view.name})`);
     },

ts_web/elements/00group-appui/dees-appui/dees-appui.ts

@@ -15,6 +15,7 @@ import type { DeesAppuiMainmenu } from '../dees-appui-mainmenu/dees-appui-mainme
 import type { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
 import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js';
 import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js';
+import type { DeesAppuiBottombar } from '../dees-appui-bottombar/dees-appui-bottombar.js';
 import { demoFunc } from './dees-appui.demo.js';
 import { themeDefaultStyles } from '../../00theme.js';
 
@@ -23,6 +24,7 @@ import { ViewRegistry } from './view.registry.js';
 
 // Import child components
 import '../dees-appui-appbar/index.js';
+import '../dees-appui-bottombar/dees-appui-bottombar.js';
 import '../dees-appui-mainmenu/dees-appui-mainmenu.js';
 import '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
 import '../dees-appui-maincontent/dees-appui-maincontent.js';
@@ -156,6 +158,12 @@ export class DeesAppui extends DeesElement {
   @state()
   accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined;
 
+  @state()
+  accessor bottombarElement: DeesAppuiBottombar | undefined = undefined;
+
+  @state()
+  accessor bottombarVisible: boolean = true;
+
   // Current view state
   @state()
   accessor currentView: interfaces.IViewDefinition | undefined = undefined;
@@ -179,12 +187,25 @@ export class DeesAppui extends DeesElement {
       .maingrid {
         position: absolute;
         top: 40px;
-        height: calc(100% - 40px);
+        height: calc(100% - 40px - 24px);
         width: 100%;
         display: grid;
         /* grid-template-columns set dynamically in template */
         grid-template-rows: 1fr;
-        transition: grid-template-columns 0.3s ease;
+        transition: grid-template-columns 0.3s ease, height 0.3s ease;
+        overflow: hidden;
+      }
+
+      :host([bottombar-hidden]) .maingrid {
+        height: calc(100% - 40px);
+      }
+
+      dees-appui-bottombar {
+        position: absolute;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        z-index: 4;
       }
 
       /* Z-index layering for proper stacking */
@@ -201,6 +222,7 @@ export class DeesAppui extends DeesElement {
       .maingrid > dees-appui-maincontent {
         position: relative;
         z-index: 1;
+        min-height: 0;
       }
 
       .maingrid > dees-appui-activitylog {
@@ -293,6 +315,9 @@ export class DeesAppui extends DeesElement {
           class="${this.activityLogVisible ? 'visible' : 'hidden'}"
         ></dees-appui-activitylog>
       </div>
+      ${this.bottombarVisible ? html`
+        <dees-appui-bottombar></dees-appui-bottombar>
+      ` : ''}
     `;
   }
 
@@ -303,6 +328,7 @@ export class DeesAppui extends DeesElement {
     this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu;
     this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent;
     this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog;
+    this.bottombarElement = this.shadowRoot!.querySelector('dees-appui-bottombar') as DeesAppuiBottombar;
 
     // Subscribe to activity log entry changes for badge count
     if (this.activitylogElement) {
@@ -728,6 +754,72 @@ export class DeesAppui extends DeesElement {
     return this.activityLogVisible;
   }
 
+  // ==========================================
+  // PROGRAMMATIC API: BOTTOM BAR
+  // ==========================================
+
+  /**
+   * Get the bottom bar API for widget/action management
+   */
+  public get bottomBar(): interfaces.IBottomBarAPI {
+    if (!this.bottombarElement) {
+      // Return a deferred API that will work after firstUpdated
+      return {
+        addWidget: (widget) => {
+          this.updateComplete.then(() => this.bottombarElement?.addWidget(widget));
+        },
+        updateWidget: (id, update) => {
+          this.updateComplete.then(() => this.bottombarElement?.updateWidget(id, update));
+        },
+        removeWidget: (id) => {
+          this.updateComplete.then(() => this.bottombarElement?.removeWidget(id));
+        },
+        getWidget: (id) => this.bottombarElement?.getWidget(id),
+        clearWidgets: () => {
+          this.updateComplete.then(() => this.bottombarElement?.clearWidgets());
+        },
+        addAction: (action) => {
+          this.updateComplete.then(() => this.bottombarElement?.addAction(action));
+        },
+        removeAction: (id) => {
+          this.updateComplete.then(() => this.bottombarElement?.removeAction(id));
+        },
+        clearActions: () => {
+          this.updateComplete.then(() => this.bottombarElement?.clearActions());
+        },
+      };
+    }
+    return {
+      addWidget: (widget) => this.bottombarElement!.addWidget(widget),
+      updateWidget: (id, update) => this.bottombarElement!.updateWidget(id, update),
+      removeWidget: (id) => this.bottombarElement!.removeWidget(id),
+      getWidget: (id) => this.bottombarElement!.getWidget(id),
+      clearWidgets: () => this.bottombarElement!.clearWidgets(),
+      addAction: (action) => this.bottombarElement!.addAction(action),
+      removeAction: (id) => this.bottombarElement!.removeAction(id),
+      clearActions: () => this.bottombarElement!.clearActions(),
+    };
+  }
+
+  /**
+   * Set bottom bar visibility
+   */
+  public setBottomBarVisible(visible: boolean): void {
+    this.bottombarVisible = visible;
+    if (!visible) {
+      this.setAttribute('bottombar-hidden', '');
+    } else {
+      this.removeAttribute('bottombar-hidden');
+    }
+  }
+
+  /**
+   * Get bottom bar visibility state
+   */
+  public getBottomBarVisible(): boolean {
+    return this.bottombarVisible;
+  }
+
   // ==========================================
   // PROGRAMMATIC API: NAVIGATION
   // ==========================================
@@ -840,6 +932,23 @@ export class DeesAppui extends DeesElement {
       }
     }
 
+    // Apply bottom bar config
+    if (config.bottomBar) {
+      this.setBottomBarVisible(config.bottomBar.visible ?? true);
+
+      if (config.bottomBar.widgets) {
+        config.bottomBar.widgets.forEach(widget => {
+          this.bottomBar.addWidget(widget);
+        });
+      }
+
+      if (config.bottomBar.actions) {
+        config.bottomBar.actions.forEach(action => {
+          this.bottomBar.addAction(action);
+        });
+      }
+    }
+
     // Setup domtools.router integration
     this.setupRouterIntegration(config);
 

ts_web/elements/00group-appui/dees-appui/readme.md

@@ -1,6 +1,6 @@
 # DeesAppui
 
-A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management.
+A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management. 🚀
 
 ## Quick Start
 
@@ -35,6 +35,34 @@ class MyApp extends DeesElement {
 }
 ```
 
+## Architecture Overview
+
+The DeesAppui shell consists of several interconnected components:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  AppBar (dees-appui-appbar)                                         │
+│  ├── Menus (File, Edit, View...)                                    │
+│  ├── Breadcrumbs                                                    │
+│  ├── User Profile + Dropdown                                        │
+│  └── Activity Log Toggle                                            │
+├─────────────┬───────────────────────────────────┬───────────────────┤
+│ Main Menu   │  Content Area                     │  Activity Log     │
+│ (collapsed/ │  ├── Content Tabs                 │  (slide panel)    │
+│  expanded)  │  │   (closable, from tables/lists)│                   │
+│             │  └── View Container               │                   │
+│ ┌─────────┐ │      └── Active View              │                   │
+│ │ 🏠 Home │ ├─────────────────────────────────┐ │                   │
+│ │ 📁 Files│ │ Secondary Menu                  │ │                   │
+│ │ ⚙ Settings ├── Collapsible Groups            │ │                   │
+│ │         │ │   ├── Item 1                    │ │                   │
+│ └─────────┘ │   ├── Item 2 (with badge)       │ │                   │
+│             │   └── Item 3                    │ │                   │
+└─────────────┴─────────────────────────────────┴───────────────────────┘
+```
+
+---
+
 ## Configuration API
 
 ### `configure(config: IAppConfig)`
@@ -155,74 +183,289 @@ appui.removeMainMenuItem('Main', 'tasks');
 
 // Selection
 appui.setMainMenuSelection('dashboard');
-appui.setMainMenuCollapsed(true);
+
+// Visibility control
+appui.setMainMenuCollapsed(true);     // Collapse to icon-only sidebar
+appui.setMainMenuVisible(false);       // Hide completely
 
 // Badges
 appui.setMainMenuBadge('inbox', 12);
 appui.clearMainMenuBadge('inbox');
 ```
 
-### Secondary Menu API
+---
 
-Views can control the secondary (contextual) menu.
+## Secondary Menu API 📋
+
+The secondary menu is a contextual sidebar that appears next to the main content area. It supports **collapsible groups** with icons and badges, making it perfect for:
+
+- **Settings pages** (grouped settings categories)
+- **File browsers** (folder trees)
+- **Project navigation** (grouped by category)
+- **Documentation** (chapters/sections)
+
+### Collapsible Groups
+
+Groups can be collapsed/expanded by clicking the group header. The state is visually indicated with an icon rotation.
 
 ```typescript
-// Set menu
+// Set secondary menu with collapsible groups
 appui.setSecondaryMenu({
   heading: 'Settings',
   groups: [
     {
       name: 'Account',
+      iconName: 'lucide:user',        // Group icon
+      collapsed: false,                // Initial state (default: false)
       items: [
-        { key: 'profile', iconName: 'lucide:user', action: () => {} },
+        { key: 'profile', iconName: 'lucide:user', action: () => showProfile() },
-        { key: 'security', iconName: 'lucide:shield', action: () => {} },
+        { key: 'security', iconName: 'lucide:shield', badge: '!', badgeVariant: 'warning', action: () => showSecurity() },
+        { key: 'billing', iconName: 'lucide:credit-card', action: () => showBilling() }
+      ]
+    },
+    {
+      name: 'Preferences',
+      iconName: 'lucide:settings',
+      collapsed: true,                 // Start collapsed
+      items: [
+        { key: 'notifications', iconName: 'lucide:bell', action: () => {} },
+        { key: 'appearance', iconName: 'lucide:palette', action: () => {} },
+        { key: 'language', iconName: 'lucide:globe', action: () => {} }
       ]
     }
   ]
 });
+```
 
-// Update group
+### Secondary Menu Item Properties
-appui.updateSecondaryMenuGroup('Account', { items: newItems });
 
-// Add item
+```typescript
-appui.addSecondaryMenuItem('Account', {
+interface ISecondaryMenuItem {
-  key: 'notifications',
+  key: string;                    // Unique identifier
-  iconName: 'lucide:bell',
+  iconName?: string;              // Icon (e.g., 'lucide:user')
-  action: () => {}
+  action: () => void;             // Click handler
+  badge?: string | number;        // Badge text/count
+  badgeVariant?: 'default' | 'success' | 'warning' | 'error';
+}
+
+interface ISecondaryMenuGroup {
+  name: string;                   // Group name (shown in header)
+  iconName?: string;              // Group icon
+  collapsed?: boolean;            // Initial collapsed state
+  items: ISecondaryMenuItem[];    // Items in this group
+}
+```
+
+### Updating Secondary Menu
+
+```typescript
+// Update a specific group
+appui.updateSecondaryMenuGroup('Account', {
+  items: [...newItems]
 });
 
-// Selection
+// Add item to a group
+appui.addSecondaryMenuItem('Account', {
+  key: 'api-keys',
+  iconName: 'lucide:key',
+  action: () => showApiKeys()
+});
+
+// Selection (highlights the item)
 appui.setSecondaryMenuSelection('profile');
 
+// Visibility control
+appui.setSecondaryMenuCollapsed(true);   // Collapse panel
+appui.setSecondaryMenuVisible(false);     // Hide completely
+
 // Clear
 appui.clearSecondaryMenu();
 ```
 
-### Content Tabs API
+### View-Specific Secondary Menus
 
-Control tabs in the main content area.
+Each view can define its own secondary menu that appears when the view is activated:
 
 ```typescript
-// Set tabs
+// In view definition
-appui.setContentTabs([
+{
-  { key: 'code', iconName: 'lucide:code', action: () => {} },
+  id: 'settings',
-  { key: 'preview', iconName: 'lucide:eye', action: () => {} }
+  name: 'Settings',
-]);
+  content: 'my-settings-view',
+  secondaryMenu: [
+    {
+      name: 'General',
+      items: [
+        { key: 'account', iconName: 'lucide:user', action: () => {} },
+        { key: 'security', iconName: 'lucide:shield', action: () => {} }
+      ]
+    }
+  ]
+}
 
-// Add/remove
+// Or set dynamically in view's onActivate hook
-appui.addContentTab({ key: 'debug', iconName: 'lucide:bug', action: () => {} });
+onActivate(context: IViewActivationContext) {
-appui.removeContentTab('debug');
+  context.appui.setSecondaryMenu({
-
+    heading: 'Project Files',
-// Select
+    groups: [...]
-appui.selectContentTab('preview');
+  });
-
+}
-// Get current
-const current = appui.getSelectedContentTab();
 ```
 
-### Activity Log API
+---
 
-Add activity entries to the right-side activity log.
+## Content Tabs API 📑
+
+Content tabs appear above the main view content. They're designed for **opening multiple items** from tables, lists, or other data sources—similar to browser tabs or IDE editor tabs.
+
+### Common Use Cases
+
+- **Table row details** - Click a row to open it as a tab
+- **Document editing** - Open multiple documents
+- **Entity inspection** - View customer, order, product details
+- **Multi-file editing** - Edit multiple configuration files
+
+### Closable Tabs
+
+Tabs can be closable, allowing users to open items, work with them, and close when done:
+
+```typescript
+// Set initial tabs
+appui.setContentTabs([
+  { key: 'overview', iconName: 'lucide:home', action: () => showOverview() },
+  { key: 'activity', iconName: 'lucide:activity', action: () => showActivity() }
+]);
+
+// Add a closable tab when user clicks a table row
+table.addEventListener('row-click', (e) => {
+  const item = e.detail.item;
+
+  appui.addContentTab({
+    key: `item-${item.id}`,
+    label: item.name,                      // Display label
+    iconName: 'lucide:file',
+    closable: true,                        // Allow closing
+    action: () => showItemDetails(item)
+  });
+
+  // Select the new tab
+  appui.selectContentTab(`item-${item.id}`);
+});
+
+// Handle tab close
+appui.addEventListener('tab-close', (e) => {
+  const tabKey = e.detail.key;
+  // Cleanup resources if needed
+  console.log(`Tab ${tabKey} closed`);
+});
+```
+
+### Tab Management
+
+```typescript
+// Add/remove tabs
+appui.addContentTab({
+  key: 'debug',
+  iconName: 'lucide:bug',
+  closable: true,
+  action: () => {}
+});
+appui.removeContentTab('debug');
+
+// Select tab
+appui.selectContentTab('preview');
+
+// Get current tab
+const current = appui.getSelectedContentTab();
+
+// Visibility control
+appui.setContentTabsVisible(false);        // Hide tab bar
+
+// Auto-hide when only one tab
+appui.setContentTabsAutoHide(true, 1);     // Hide when ≤ 1 tab
+```
+
+### Opening Items from Tables/Lists
+
+A common pattern is opening table rows as closable tabs:
+
+```typescript
+@customElement('my-customers-view')
+class MyCustomersView extends DeesElement {
+  private appui: DeesAppui;
+
+  onActivate(context: IViewActivationContext) {
+    this.appui = context.appui;
+
+    // Set base tabs
+    this.appui.setContentTabs([
+      { key: 'list', label: 'All Customers', iconName: 'lucide:users', action: () => this.showList() }
+    ]);
+  }
+
+  render() {
+    return html`
+      <dees-table
+        .data=${this.customers}
+        @row-dblclick=${this.openCustomerTab}
+      ></dees-table>
+    `;
+  }
+
+  openCustomerTab(e: CustomEvent) {
+    const customer = e.detail.item;
+    const tabKey = `customer-${customer.id}`;
+
+    // Check if tab already exists
+    const existingTab = this.appui.getSelectedContentTab();
+    if (existingTab?.key === tabKey) {
+      return; // Already viewing this customer
+    }
+
+    // Add new closable tab
+    this.appui.addContentTab({
+      key: tabKey,
+      label: customer.name,
+      iconName: 'lucide:user',
+      closable: true,
+      action: () => this.showCustomerDetails(customer)
+    });
+
+    this.appui.selectContentTab(tabKey);
+  }
+
+  showCustomerDetails(customer: Customer) {
+    // Render customer details
+    this.currentView = html`<customer-details .customer=${customer}></customer-details>`;
+  }
+
+  showList() {
+    this.currentView = html`<dees-table ...></dees-table>`;
+  }
+}
+```
+
+---
+
+## Activity Log API 📊
+
+The activity log is a slide-out panel on the right side showing user actions and system events.
+
+### Activity Log Toggle
+
+The appbar includes a toggle button with a badge showing the entry count:
+
+```typescript
+// Control visibility
+appui.setActivityLogVisible(true);     // Show panel
+appui.toggleActivityLog();             // Toggle state
+const isVisible = appui.getActivityLogVisible();
+
+// The toggle button automatically shows entry count
+// Add entries and the badge updates automatically
+```
+
+### Adding Entries
 
 ```typescript
 // Add single entry
@@ -234,19 +477,35 @@ appui.activityLog.add({
   data: { invoiceId: '123' }     // Optional metadata
 });
 
-// Add multiple
+// Add multiple entries (e.g., from backend)
 appui.activityLog.addMany([...entries]);
 
-// Clear
+// Clear all entries
 appui.activityLog.clear();
 
-// Query
+// Query entries
 const entries = appui.activityLog.getEntries();
 const filtered = appui.activityLog.filter({ user: 'John', type: 'create' });
 const searched = appui.activityLog.search('invoice');
 ```
 
-### Navigation API
+### Activity Entry Types
+
+Each type has a default icon that can be overridden:
+
+| Type | Default Icon | Use Case |
+|------|--------------|----------|
+| `login` | `lucide:log-in` | User sign-in |
+| `logout` | `lucide:log-out` | User sign-out |
+| `view` | `lucide:eye` | Page/item viewed |
+| `create` | `lucide:plus` | New item created |
+| `update` | `lucide:pencil` | Item modified |
+| `delete` | `lucide:trash` | Item deleted |
+| `custom` | `lucide:activity` | Custom events |
+
+---
+
+## Navigation API
 
 Navigate between views programmatically.
 
@@ -512,6 +771,7 @@ class CrmSettings extends DeesElement {
       groups: [
         {
           name: 'Account',
+          iconName: 'lucide:user',
           items: [
             { key: 'profile', iconName: 'lucide:user', action: () => this.showSection('profile') },
             { key: 'security', iconName: 'lucide:shield', action: () => this.showSection('security') }
@@ -519,6 +779,8 @@ class CrmSettings extends DeesElement {
         },
         {
           name: 'Preferences',
+          iconName: 'lucide:settings',
+          collapsed: true,
           items: [
             { key: 'notifications', iconName: 'lucide:bell', action: () => this.showSection('notifications') }
           ]
@@ -557,4 +819,5 @@ All interfaces are exported from `@design.estate/dees-catalog`:
 - `IAppBarMenuItem` - App bar menu item
 - `IMainMenuConfig` - Main menu configuration
 - `ISecondaryMenuGroup` - Secondary menu group
-- `ITab` - Tab definition
+- `ISecondaryMenuItem` - Secondary menu item
+- `IMenuItem` - Tab/menu item definition

ts_web/elements/00group-appui/index.ts

@@ -1,6 +1,7 @@
 // App UI Components
 export * from './dees-appui-activitylog/index.js';
 export * from './dees-appui-appbar/index.js';
+export * from './dees-appui-bottombar/index.js';
 export * from './dees-appui/index.js';
 export * from './dees-appui-maincontent/index.js';
 export * from './dees-appui-mainmenu/index.js';

ts_web/elements/dees-icon/dees-icon.ts

@@ -257,12 +257,13 @@ export class DeesIcon extends DeesElement {
    * @returns Object with type and name properties
    */
   private parseIconString(iconStr: string): { type: 'fa' | 'lucide', name: string } {
-    if (iconStr.startsWith('fa:')) {
+    const lowerStr = iconStr.toLowerCase();
+    if (lowerStr.startsWith('fa:')) {
       return {
         type: 'fa',
         name: iconStr.substring(3) // Remove 'fa:' prefix
       };
-    } else if (iconStr.startsWith('lucide:')) {
+    } else if (lowerStr.startsWith('lucide:')) {
       return {
         type: 'lucide',
         name: iconStr.substring(7) // Remove 'lucide:' prefix

ts_web/elements/dees-statsgrid/dees-statsgrid.ts

@@ -88,16 +88,16 @@ export class DeesStatsGrid extends DeesElement {
 
       /* CSS Variables for consistent spacing and sizing */
       :host {
-        --grid-gap: 16px;
+        --grid-gap: 12px;
-        --tile-padding: 24px;
+        --tile-padding: 16px;
-        --header-spacing: 16px;
+        --header-spacing: 12px;
-        --content-min-height: 48px;
+        --content-min-height: 40px;
-        --value-font-size: 30px;
+        --value-font-size: 26px;
-        --unit-font-size: 16px;
+        --unit-font-size: 14px;
-        --label-font-size: 13px;
+        --label-font-size: 12px;
-        --title-font-size: 14px;
+        --title-font-size: 13px;
-        --description-spacing: 12px;
+        --description-spacing: 8px;
-        --border-radius: 8px;
+        --border-radius: 6px;
         --transition-duration: 0.15s;
       }
 
@@ -136,7 +136,7 @@ export class DeesStatsGrid extends DeesElement {
       /* Tile Base Styles */
       .stats-tile {
         background: ${cssManager.bdTheme('#ffffff', '#09090b')};
-        border: 1px solid ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 11.8%)')};
+        border: 1px solid ${cssManager.bdTheme('#e0e0e0', '#202020')};
         border-radius: var(--border-radius);
         padding: var(--tile-padding);
         transition: all var(--transition-duration) ease;
@@ -148,8 +148,8 @@ export class DeesStatsGrid extends DeesElement {
       }
 
       .stats-tile:hover {
-        background: ${cssManager.bdTheme('hsl(210 40% 98%)', 'hsl(215 20.2% 10.2%)')};
+        background: ${cssManager.bdTheme('#fafafa', '#0d0d0d')};
-        border-color: ${cssManager.bdTheme('hsl(214.3 31.8% 85%)', 'hsl(215 20.2% 16.8%)')};
+        border-color: ${cssManager.bdTheme('#d0d0d0', '#2a2a2a')};
       }
 
       .stats-tile.clickable {
@@ -158,7 +158,7 @@ export class DeesStatsGrid extends DeesElement {
 
       .stats-tile.clickable:hover {
         transform: translateY(-1px);
-        box-shadow: 0 2px 8px ${cssManager.bdTheme('rgba(0,0,0,0.04)', 'rgba(0,0,0,0.2)')};
+        box-shadow: 0 2px 6px ${cssManager.bdTheme('rgba(0,0,0,0.03)', 'rgba(0,0,0,0.15)')};
       }
 
       /* Tile Header */
@@ -230,10 +230,10 @@ export class DeesStatsGrid extends DeesElement {
       }
 
       .gauge-container {
-        width: 140px;
+        width: 120px;
-        height: 80px;
+        height: 70px;
         position: relative;
-        margin-top: -10px;
+        margin-top: -8px;
       }
 
       .gauge-svg {
@@ -243,13 +243,13 @@ export class DeesStatsGrid extends DeesElement {
 
       .gauge-background {
         fill: none;
-        stroke: ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 21.8%)')};
+        stroke: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
-        stroke-width: 8;
+        stroke-width: 6;
       }
 
       .gauge-fill {
         fill: none;
-        stroke-width: 8;
+        stroke-width: 6;
         stroke-linecap: round;
         transition: stroke-dashoffset 0.6s cubic-bezier(0.4, 0, 0.2, 1);
       }
@@ -287,17 +287,17 @@ export class DeesStatsGrid extends DeesElement {
 
       .percentage-bar {
         width: 100%;
-        height: 8px;
+        height: 6px;
-        background: ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 21.8%)')};
+        background: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
-        border-radius: 4px;
+        border-radius: 3px;
         overflow: hidden;
       }
 
       .percentage-fill {
         height: 100%;
-        background: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
+        background: ${cssManager.bdTheme('#333333', '#e0e0e0')};
         transition: width 0.6s cubic-bezier(0.4, 0, 0.2, 1);
-        border-radius: 4px;
+        border-radius: 3px;
       }
 
       /* Trend Styles */
@@ -339,7 +339,7 @@ export class DeesStatsGrid extends DeesElement {
 
       .trend-graph {
         width: 100%;
-        height: 32px;
+        height: 28px;
         position: relative;
       }
 
@@ -351,14 +351,14 @@ export class DeesStatsGrid extends DeesElement {
 
       .trend-line {
         fill: none;
-        stroke: ${cssManager.bdTheme('hsl(215.4 16.3% 66.9%)', 'hsl(215 20.2% 55.1%)')};
+        stroke: ${cssManager.bdTheme('#999999', '#666666')};
-        stroke-width: 2;
+        stroke-width: 1.5;
         stroke-linejoin: round;
         stroke-linecap: round;
       }
 
       .trend-area {
-        fill: ${cssManager.bdTheme('hsl(215.4 16.3% 66.9% / 0.1)', 'hsl(215 20.2% 55.1% / 0.08)')};
+        fill: ${cssManager.bdTheme('rgba(150, 150, 150, 0.08)', 'rgba(100, 100, 100, 0.08)')};
       }
 
       /* Text Value Styles */
@@ -480,13 +480,13 @@ export class DeesStatsGrid extends DeesElement {
     const value = typeof tile.value === 'number' ? tile.value : parseFloat(tile.value);
     const options = tile.gaugeOptions || { min: 0, max: 100 };
     const percentage = ((value - options.min) / (options.max - options.min)) * 100;
-    
+
     // SVG dimensions and calculations
-    const width = 140;
+    const width = 120;
-    const height = 80;
+    const height = 70;
-    const strokeWidth = 8;
+    const strokeWidth = 6;
     const padding = strokeWidth / 2 + 2;
-    const radius = 48;
+    const radius = 40;
     const centerX = width / 2;
     const centerY = height - padding;
     

ts_web/elements/interfaces/appconfig.ts

@@ -4,6 +4,104 @@ import type { IMenuItem } from './tab.js';
 import type { IMenuGroup } from './menugroup.js';
 import type { ISecondaryMenuGroup, ISecondaryMenuItem } from './secondarymenu.js';
 
+// ==========================================
+// BOTTOM BAR INTERFACES
+// ==========================================
+
+/**
+ * Bottom bar widget status for styling
+ */
+export type TBottomBarWidgetStatus = 'idle' | 'active' | 'success' | 'warning' | 'error';
+
+/**
+ * Generic status widget for the bottom bar
+ */
+export interface IBottomBarWidget {
+  /** Unique identifier for the widget */
+  id: string;
+  /** Icon to display (lucide icon name) */
+  iconName?: string;
+  /** Text label to display */
+  label?: string;
+  /** Status affects styling (colors) */
+  status?: TBottomBarWidgetStatus;
+  /** Tooltip text */
+  tooltip?: string;
+  /** Whether the widget shows a loading spinner */
+  loading?: boolean;
+  /** Click handler for the widget */
+  onClick?: () => void;
+  /** Optional context menu items on right-click */
+  contextMenuItems?: IBottomBarContextMenuItem[];
+  /** Position: 'left' (default) or 'right' */
+  position?: 'left' | 'right';
+  /** Order within position group (lower = earlier) */
+  order?: number;
+}
+
+/**
+ * Context menu item for bottom bar widgets
+ */
+export interface IBottomBarContextMenuItem {
+  name: string;
+  iconName?: string;
+  action: () => void | Promise<void>;
+  disabled?: boolean;
+  divider?: boolean;
+}
+
+/**
+ * Bottom bar action (quick action button)
+ */
+export interface IBottomBarAction {
+  /** Unique identifier */
+  id: string;
+  /** Icon to display */
+  iconName: string;
+  /** Tooltip */
+  tooltip?: string;
+  /** Click handler */
+  onClick: () => void | Promise<void>;
+  /** Whether action is disabled */
+  disabled?: boolean;
+  /** Position: 'left' or 'right' (default) */
+  position?: 'left' | 'right';
+}
+
+/**
+ * Bottom bar configuration
+ */
+export interface IBottomBarConfig {
+  /** Whether bottom bar is visible */
+  visible?: boolean;
+  /** Initial widgets */
+  widgets?: IBottomBarWidget[];
+  /** Initial actions */
+  actions?: IBottomBarAction[];
+}
+
+/**
+ * Bottom bar programmatic API
+ */
+export interface IBottomBarAPI {
+  /** Add a widget */
+  addWidget: (widget: IBottomBarWidget) => void;
+  /** Update an existing widget by ID */
+  updateWidget: (id: string, update: Partial<IBottomBarWidget>) => void;
+  /** Remove a widget by ID */
+  removeWidget: (id: string) => void;
+  /** Get a widget by ID */
+  getWidget: (id: string) => IBottomBarWidget | undefined;
+  /** Clear all widgets */
+  clearWidgets: () => void;
+  /** Add an action button */
+  addAction: (action: IBottomBarAction) => void;
+  /** Remove an action by ID */
+  removeAction: (id: string) => void;
+  /** Clear all actions */
+  clearActions: () => void;
+}
+
 // Forward declaration for circular reference
 export type TDeesAppui = HTMLElement & {
   setAppBarMenus: (menus: IAppBarMenuItem[]) => void;
@@ -42,6 +140,10 @@ export type TDeesAppui = HTMLElement & {
   getActivityLogVisible: () => boolean;
   navigateToView: (viewId: string, params?: Record<string, string>) => Promise<boolean>;
   getCurrentView: () => IViewDefinition | undefined;
+  // Bottom bar
+  bottomBar: IBottomBarAPI;
+  setBottomBarVisible: (visible: boolean) => void;
+  getBottomBarVisible: () => boolean;
 };
 
 /**
@@ -233,6 +335,9 @@ export interface IAppConfig {
   /** Activity log configuration */
   activityLog?: IActivityLogConfig;
 
+  /** Bottom bar configuration */
+  bottomBar?: IBottomBarConfig;
+
   /** Event callbacks */
   onViewChange?: (viewId: string, view: IViewDefinition) => void;
   onSearch?: (query: string) => void;