From b7e0d900ff30bfac5d9ed36a64e9a3d84b3a793d Mon Sep 17 00:00:00 2001
From: mmabdalla <101379618+mmabdalla@users.noreply.github.com>
Date: Mon, 29 Dec 2025 00:51:29 +0200
Subject: [PATCH] Update sidebar label to Theme Builder and add implementation
 prompt

---
 docs/BOSA_SIDEBAR_IMPLEMENTATION_PROMPT.md | 36 ++++++++++++++++++++++
 docs/BOSA_SIDEBAR_PROMPT.txt               | 21 +++++++++++++
 manifest.yaml                              |  2 +-
 sidebar.json                               |  2 +-
 4 files changed, 59 insertions(+), 2 deletions(-)
 create mode 100644 docs/BOSA_SIDEBAR_IMPLEMENTATION_PROMPT.md
 create mode 100644 docs/BOSA_SIDEBAR_PROMPT.txt

diff --git a/docs/BOSA_SIDEBAR_IMPLEMENTATION_PROMPT.md b/docs/BOSA_SIDEBAR_IMPLEMENTATION_PROMPT.md
new file mode 100644
index 0000000..50fa25d
--- /dev/null
+++ b/docs/BOSA_SIDEBAR_IMPLEMENTATION_PROMPT.md
@@ -0,0 +1,36 @@
+# BOSA Sidebar Integration for BP_WB
+
+## Task
+Add sidebar link support for apps in the `apps/` directory. BP_WB app needs a sidebar link labeled **"Theme Builder"** that appears for Super Admin users only, positioned after the "Themes" link.
+
+## Requirements
+
+1. **Read sidebar configuration from apps:**
+   - Scan `apps/*/manifest.yaml` for `sidebar` section
+   - Or scan `apps/*/sidebar.json` files
+   - Merge app sidebar links with core sidebar links
+
+2. **Configuration format:**
+   ```yaml
+   # In apps/bp_wb/manifest.yaml
+   sidebar:
+     label: Theme Builder
+     url: /bp_wb/
+     icon: pencil-square
+     role: super_admin
+     position: after
+     after: themes
+   ```
+
+3. **Filtering:**
+   - Only show links where `role: "super_admin"` for Super Admin users
+   - Hide links for users without required role
+
+4. **Positioning:**
+   - Support `position: "after"` with `after: "themes"` to place link after Themes
+   - Support `position: "before"` for placing before specific links
+   - Support `position: "append"` for adding to end of sidebar
+
+## Expected Result
+When BP_WB is deployed to `apps/bp_wb/`, Super Admin users should see a "Theme Builder" link in the sidebar immediately after the "Themes" link, linking to `/bp_wb/`.
+
diff --git a/docs/BOSA_SIDEBAR_PROMPT.txt b/docs/BOSA_SIDEBAR_PROMPT.txt
new file mode 100644
index 0000000..7744768
--- /dev/null
+++ b/docs/BOSA_SIDEBAR_PROMPT.txt
@@ -0,0 +1,21 @@
+BOSA Sidebar Integration for BP_WB
+
+Add sidebar link support for apps in apps/ directory. BP_WB needs a "Theme Builder" link for Super Admin only, positioned after "Themes".
+
+Requirements:
+1. Read sidebar config from apps/*/manifest.yaml (sidebar section) or apps/*/sidebar.json
+2. Filter by role (super_admin only)
+3. Support positioning: position: "after" with after: "themes"
+4. Merge app links with core sidebar links
+
+Config format (apps/bp_wb/manifest.yaml):
+  sidebar:
+    label: Theme Builder
+    url: /bp_wb/
+    icon: pencil-square
+    role: super_admin
+    position: after
+    after: themes
+
+Result: Super Admin sees "Theme Builder" link after "Themes" → /bp_wb/
+
diff --git a/manifest.yaml b/manifest.yaml
index 1ab50a7..d704b61 100644
--- a/manifest.yaml
+++ b/manifest.yaml
@@ -5,7 +5,7 @@ author: BOSA Team
 
 # Sidebar configuration for Super Admin
 sidebar:
-  label: Website Builder
+  label: Theme Builder
   url: /bp_wb/
   icon: pencil-square
   role: super_admin
diff --git a/sidebar.json b/sidebar.json
index 340dba5..2593bfd 100644
--- a/sidebar.json
+++ b/sidebar.json
@@ -2,7 +2,7 @@
   "sidebar": {
     "links": [
       {
-        "label": "Website Builder",
+        "label": "Theme Builder",
         "url": "/bp_wb/",
         "icon": "pencil-square",
         "role": "super_admin",