app-shell

What problem does it solve?

It solves the complexity of maintaining a consistent, user-friendly “control center” in a Kubernetes desktop GUI—covering settings, command palette, navigation, dockable panels, favorites, and the persistence rules that keep the UI feeling stable across sessions.

Core Features & Use Cases

• Unified UX contracts for app shell areas: Provides shared contracts for settings metadata flow, command palette integration, keyboard/shortcut focus behavior, modal accessibility, and dockable panel/tab identity.
• Persistence and state correctness: Defines how persisted app preferences hydrate from backend schema metadata and how layout/panel defaults are normalized and stored.
• Operational guidance for UI teams: Ensures settings UI doesn’t duplicate backend constants, uses the typed helpers in core/settings, and applies UpdateAppPreferences semantics with rollback on failure.
• Visual and interaction safety: Emphasizes focus trapping, drag/drop selection behavior, and deterministic tests for visual shell behavior.

Quick Start

Use the app-shell skill to update the command palette and dockable panel behavior by following the listed core contracts and checklist for persistence, focus, shortcuts, and visual shell tests.