Skip to content

Commit 5c9aec4

Browse files
feat: improve kiba-welcome UX and accessibility
Enhanced the kiba-welcome onboarding tool by adding a Terminal launcher, a productivity tip for the Meta+T shortcut, and improving desktop entry metadata for better accessibility. Co-authored-by: christopherfoxjr <213370400+christopherfoxjr@users.noreply.github.com>
1 parent 9c6205c commit 5c9aec4

2 files changed

Lines changed: 14 additions & 2 deletions

File tree

.Jules/palette.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,8 @@
99

1010
**Learning:** For documentation-heavy repositories, the README is the primary UI. Long READMEs (>100 lines) require a "Table of Contents" for better navigability (and to pass CI audits), and hero images must have descriptive alt text to ensure an accessible first impression for screen-reader users.
1111
**Action:** Always include a Table of Contents for READMEs exceeding 100 lines and audit all documentation images for descriptive `alt` attributes instead of generic placeholders like "image".
12+
13+
## 2026-05-11 - [Onboarding Discoverability & Accessibility Metadata]
14+
15+
**Learning:** Surfacing core system capabilities (like the terminal) and their associated keyboard shortcuts (e.g., Meta+T) directly in onboarding tools significantly reduces friction for new users. Furthermore, desktop entries for such tools must include `GenericName` and proper `Categories` to ensure they are properly indexed and categorized by desktop environments' accessibility and search features.
16+
**Action:** Include "Quick Tips" for keyboard shortcuts in welcome dialogs and ensure `.desktop` files for system tools have complete metadata (`GenericName`, `Comment`, `Categories`).

.github/workflows/kiba.yml

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1260,10 +1260,11 @@ jobs:
12601260
while true; do
12611261
CHOICE=$(zenity --list --title="Welcome to KibaOS" \
12621262
--window-icon="/usr/share/kibaos/logo.png" \
1263-
--text="Welcome to KibaOS! What would you like to do?" \
1263+
--text="Welcome to KibaOS! What would you like to do?\n\nTip: Press Meta+T to open the terminal anytime." \
12641264
--image-column=1 --column=" " --column="Tag" --column="Action" --column="Description" \
12651265
"calamares" "install" "🚀 Install KibaOS" "Install the system permanently to your disk" \
12661266
"chromium" "browser" "🌐 Web Browser" "Browse the internet" \
1267+
"utilities-terminal" "terminal" "🖥️ Terminal" "Open the modern KibaOS shell" \
12671268
"org.kde.discover" "store" "🛍️ Software Center" "Discover and install new applications" \
12681269
"input-keyboard" "shortcuts" "⌨️ Keyboard Shortcuts" "View useful desktop shortcuts" \
12691270
"help-browser" "wiki" "✨ Online Wiki" "Read the technical documentation" \
@@ -1285,6 +1286,10 @@ jobs:
12851286
plasma-discover &
12861287
break
12871288
;;
1289+
"terminal")
1290+
konsole &
1291+
break
1292+
;;
12881293
"shortcuts")
12891294
(zenity --list --title="KibaOS Shortcuts" \
12901295
--window-icon="/usr/share/kibaos/logo.png" \
@@ -1317,10 +1322,12 @@ jobs:
13171322
[Desktop Entry]
13181323
Type=Application
13191324
Name=Kiba Welcome
1320-
Comment=Welcome to KibaOS
1325+
GenericName=Onboarding Tool
1326+
Comment=Get started with KibaOS and view system shortcuts
13211327
Exec=/usr/local/bin/kiba-welcome
13221328
Icon=start-here-kde-symbolic
13231329
Terminal=false
1330+
Categories=Qt;KDE;System;
13241331
X-KDE-autostart-condition=kiba-welcome
13251332
WELCOMEDESK
13261333

0 commit comments

Comments
 (0)