🎨 Palette: Enhance kiba-welcome UX and discoverability

.Jules/palette.md

@@ -9,9 +9,21 @@
 **Action:** Only use `break` for primary actions that launch a full application or process (like the installer) in looping welcome tools.
 
 ## 2025-05-15 - [Discoverable Shortcuts in Menu Labels]
+
 **Learning:** Incorporating keyboard shortcut hints (e.g., "Terminal (Meta+T)") directly into Zenity menu labels in the `kiba-welcome` tool improves functional discoverability and teaches users efficient interaction methods within the live environment.
 **Action:** Include shortcut hints in labels for primary system tools to enhance user onboarding and system proficiency.
 
 ## 2025-05-16 - [Search-Friendly Desktop Metadata]
+
 **Learning:** Enhancing `.desktop` files with descriptive `GenericName` (e.g., 'Package Manager') and relevant `Keywords` (e.g., 'software;install') ensures core tools are findable via natural language search launchers even if the formal app name is unfamiliar.
 **Action:** Always include `GenericName` and `Keywords` in system-level `.desktop` entries to improve application discoverability and accessibility.
+
+## 2026-05-07 - [Non-Blocking Informational Dialogs]
+
+**Learning:** Backgrounding informational Zenity dialogs (like "Shortcuts" or "Documentation") with `&` in selection loops prevents the menu from being blocked, allowing users to keep the menu open while viewing information.
+**Action:** Always background informational popups in looping menus to maintain UI responsiveness and parallel exploration.
+
+## 2026-05-07 - [Icon Consistency: Monitor vs Laptop]
+
+**Learning:** For desktop distributions like KibaTV, using the desktop monitor emoji (🖥️) for the Terminal icon is more contextually appropriate and consistent with system-wide branding than the laptop emoji (💻).
+**Action:** Use 🖥️ for terminal-related UI elements in desktop-focused environments.

.github/workflows/audit-build-zsh-alias-check.yml

@@ -13,4 +13,4 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
       - name: Check Alias
         run: |
-          grep 'alias please=\'sudo\'' scripts/kibatv-build.sh
+          grep "alias please='sudo'" scripts/kibatv-build.sh

scripts/kibatv-build.sh

@@ -1,5 +1,9 @@
 #!/bin/bash
 # License: MIT
+if [ "$#" -ne 0 ]; then
+  echo "Usage: $0"
+  exit 1
+fi
 set -o pipefail
 set -euo pipefail
 set -o pipefail
@@ -133,11 +137,13 @@
 while true; do
   CHOICE=$(zenity --list --title="Welcome to KibaTV" \
     --window-icon="/usr/share/kibatv/logo.png" \
+    --width=450 --height=500 \
     --column="Action" --column="Description" \
     "🚀 Install KibaTV" "Install the system to your drive" \
     "🛍️ App Store" "Browse and install applications" \
-    "💻 Terminal (Meta+T)" "Open the command line" \
+    "🖥️ Terminal (Meta+T)" "Open the command line" \
     "🌐 Web Browser" "Browse the internet" \
+    "📖 Documentation" "Read the technical manual" \
     "✨ Shortcuts" "View system keyboard shortcuts" \
     "🚪 Exit" "Close the welcome screen")
 
@@ -149,18 +155,21 @@
     "🛍️ App Store")
       kstore &
       ;;
-    "💻 Terminal (Meta+T)")
+    "🖥️ Terminal (Meta+T)")
       konsole &
       ;;
     "🌐 Web Browser")
       chromium &
       ;;
+    "📖 Documentation")
+      chromium --app=https://github.com/WolfTech-Innovations/Kiba &
+      ;;
     "✨ Shortcuts")
       zenity --info --title="Shortcuts" --text="Terminal: Meta+T
 Launcher: Meta
 Quick Settings: Meta+A
 Search: Meta+S
-Overview: Meta+W"
+Overview: Meta+W" &
       ;;
     "🚪 Exit")
       break
@@ -185,7 +194,7 @@
 Icon=kiba-logo
 Terminal=false
 Categories=System;
-Keywords=welcome;guide;help;kiba;
+Keywords=welcome;guide;help;kiba;setup;start;
 EOF
 
   # ── SDDM autologin ───────────────────────────────────────────────────
@@ -430,3 +439,3 @@
   install -dm755 "$pkgdir/usr/share/kibatv"
   TMPFILE=$(mktemp)
   cat > "$TMPFILE" << 'LOGO_B64'
@@ -434,6 +443,7 @@
 LOGO_B64
   base64 -d "$TMPFILE" > "$pkgdir/usr/share/kibatv/logo.png"
   rm "$TMPFILE"
+  install -Dm644 "$pkgdir/usr/share/kibatv/logo.png" "$pkgdir/usr/share/pixmaps/kiba-logo.png"
   cp "$pkgdir/usr/share/kibatv/logo.png" \
      "$pkgdir/usr/share/plymouth/themes/kibatv-spinner/logo.png"
 }
@@ -442,7 +452,6 @@
 mkdir -p $WORKDIR
 # ── Write KStore APKBUILD ─────────────────────────────────────────────
 mkdir -p /work/pmaports/local/kstore
-srcdir="/work/pmaports/local/kstore/"
 cp "$KSTORE_BIN" /work/pmaports/local/kstore/kstore
 cat > /work/pmaports/local/kstore/APKBUILD << 'APKBUILD'
 pkgname=kstore
@@ -608,11 +617,10 @@
   > /isobuild/boot/grub/bios_combined.img
 
 # ── Build hybrid ISO ──────────────────────────────────────────────────
-eatmydata xorriso \
+eatmydata xorriso -volid "KIBATV" \
   -as mkisofs \
   -iso-level 3 \
   -full-iso9660-filenames \
-  -volid "KIBATV" \
   -eltorito-boot boot/grub/bios_combined.img \
   -no-emul-boot -boot-load-size 4 -boot-info-table \
   --grub2-boot-info \