gib/Panama
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Make Shell a category, the bar legible, and the dock a real dock

Browse Source 
Desktop & Dock becomes Shell — Bar, Dock, Control Center, Tiling,
Workspaces — the home for everything Quickshell draws. The settings-
management cluster moves to System as Sync & Backup, Appearance's
Shell tab dissolves, and 24-hour time finally lives on Date & Time,
which always owned it.

The bar gets what it never had: a way to survive the wallpaper. A
second neutral text family (follow theme, or forced light or dark),
a one-layer shadow under every glyph, and a gradient scrim for
wallpapers nothing else survives — all off by default, pixel-identical
until asked. Widgets earn toggles (weather, media, clipboard, calendar
countdown), the vitals cluster stops leaving a dead pill behind, and
Control Center's sections learn to step aside.

The dock graduates from MVP: a context menu with window rows, pin,
unpin, quit and new-window; scroll an icon to cycle its windows; drag
to reorder on the dock itself; hover previews with one-shot captures;
and "Add App to Dock" in the launcher. Three real bugs died en route —
menus that slid away with the autohide, a readonly-property crash on
every menu open, and a drag that drifted half a slot per icon on side
docks. The pinned-apps editor in Settings becomes a drag strip.

166 contracts; the full suite is green except two live display and
switcher tests that cannot run behind a locked session — re-verified
on unlock.

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8
This commit is contained in:
Gabriel Brown
2026-08-24 04:28:20 -04:00
parent 4d7a194300
commit f8f5b25510
77 changed files with 2982 additions and 800 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/settings.md
+42 -11
View File
@@ -4,7 +4,7 @@
Do not edit this file. Run `quickshell/scripts/panama-settings-docs`
after changing the schema; a contract fails when this copy is stale.
152 settings across 30 groups. 70 of them are applied to the compositor and confirmed by reading the value back.
162 settings across 33 groups. 70 of them are applied to the compositor and confirmed by reading the value back.
## accessibility
@@ -29,6 +29,20 @@ Found on **Appearance**.
| **Appearance**<br>`colorScheme` | dark | Light and dark share one identity, not two themes Choices: Dark, Light. |
| **Accent color**<br>`accentName` | blue | Drives the focused window border, the bar hairline, and every active state Choices: Prism blue, Orchid, Teal, Green, Amber, Orange, Rose, Slate. |
## bar
Found on **Shell › Bar**.
| Setting | Default | What it does |
|---|---|---|
| **Bar text**<br>`barTextTone` | theme | Follow the theme, or force a light or dark tone for the wallpaper you actually use Choices: Follow theme, Light, Dark. |
| **Bar text shadow**<br>`barTextShadow` | false | A soft dark halo under every glyph and label in the bar |
| **Bar backdrop**<br>`barBackdrop` | false | A subtle scrim fading down from the top edge |
| **Weather in the bar**<br>`showWeatherWidget` | true | Beside the clock, once a forecast has been fetched |
| **Media in the bar**<br>`showMediaWidget` | true | Now playing, click to pause |
| **Clipboard button**<br>`showClipboardButton` | true | The history stays on Super+V either way |
| **Calendar countdown**<br>`showCalendarCountdown` | true | Appears in the bar fifteen minutes before an event |
## battery
Found on **Power & Lock**.
@@ -53,13 +67,30 @@ Found on **Applications › Screen Intelligence**.
## clock
Found on **Appearance**.
Found on **Shell › Bar**.
| Setting | Default | What it does |
|---|---|---|
| **Show seconds**<br>`showSeconds` | true | Keep a precise clock in the center of the bar |
| **Show weekday**<br>`showWeekday` | true | Include the abbreviated weekday before the date |
## controlCenter
Found on **Shell › Control Center**.
| Setting | Default | What it does |
|---|---|---|
| **Focus in Control Center**<br>`ccShowFocus` | true | The session row at the top of the panel |
| **Home in Control Center**<br>`ccShowHome` | true | Your accessory shelf |
| **Phone in Control Center**<br>`ccShowPhone` | true | Vitals and reach-it actions |
## datetime
Found on **System › Date & Time**.
| Setting | Default | What it does |
|---|---|---|
| **24-hour time**<br>`use24Hour` | false | Use 18:30 instead of 6:30 PM |
| **Show seconds**<br>`showSeconds` | true | Keep a precise clock in the center of the bar |
| **Show weekday**<br>`showWeekday` | true | Include the abbreviated weekday before the date |
## display
@@ -74,7 +105,7 @@ Found on **Displays**.
## dock
Found on **Desktop & Dock**.
Found on **Shell › Dock**.
| Setting | Default | What it does |
|---|---|---|
@@ -88,7 +119,7 @@ Found on **Desktop & Dock**.
## edges
Found on **Desktop & Dock**.
Found on **Shell › Tiling**.
| Setting | Default | What it does |
|---|---|---|
@@ -118,7 +149,7 @@ Found on **Appearance**.
## focus
Found on **Desktop & Dock**.
Found on **Shell › Workspaces**.
| Setting | Default | What it does |
|---|---|---|
@@ -183,7 +214,7 @@ Found on **Appearance**.
## master
Found on **Desktop & Dock**.
Found on **Shell › Tiling**.
| Setting | Default | What it does |
|---|---|---|
@@ -194,7 +225,7 @@ Found on **Desktop & Dock**.
## multitasking
Found on **Desktop & Dock**.
Found on **Shell › Tiling**.
| Setting | Default | What it does |
|---|---|---|
@@ -222,7 +253,7 @@ Found on **Displays**.
## notices
Found on **Desktop & Dock**.
Found on **Shell › Tiling**.
| Setting | Default | What it does |
|---|---|---|
@@ -318,7 +349,7 @@ Found on **Appearance**.
## vitals
Found on **Appearance**.
Found on **Shell › Bar**.
| Setting | Default | What it does |
|---|---|---|