Write down where all of this came from
Section G, the closeout. UPSTREAM-INSPIRATION gains the second and largest borrowing round: what was taken from omarchy, end-4, caelestia, ML4W and HyDE, what was rebuilt rather than transplanted, and -- the part that matters more -- what was declined and why. Wallpaper-derived colour is declined on identity, because dynamic colour is how rices end up looking like each other. Audio visualisers are declined because a continuously repainting equaliser is the GPU-pegging animation this project avoids. Patching application internals to theme them is declined because the maintenance is unbounded and lands on whoever is holding the desktop that day. DESKTOP-PARITY gains a Portable machines section, which it has never had, because until yesterday Panama was a desktop configuration in the code as well as on the machine. Nine rows, one of them honest about not having run on hardware with a lid. The remaining-gaps list gains the four things now known to be missing rather than the one. The README stops describing a desktop from before yesterday: migrations in the install flow, the welcome and cheatsheet and manual, and laptops working with every surface hiding itself where the hardware is absent. The plan records its own outcome per section, including the two places the work departed from it: D2's template renderer deferred once D1 removed the duplication it existed to fix, and E1 inverted after using it for an afternoon.
This commit is contained in:
@@ -33,6 +33,13 @@ in order, without stopping again:
|
||||
| `setup-identity` | git config, `gh auth login`, an SSH key — whichever were asked for |
|
||||
| `install-hardware` | NVIDIA, Secure Boot enrollment, Fedora's extras, firmware — each only if it was asked for. Last, because enrollment and firmware are consumed at the next boot |
|
||||
|
||||
Then `panama migrate` applies any repairs this machine has not had yet. That is
|
||||
the half of an upgrade installing cannot do: the stages above only ever add, so
|
||||
nothing there can remove a file this repository stopped shipping or repair a
|
||||
symlink that now points nowhere. A fresh machine is marked as already caught up
|
||||
rather than having those repairs run against it, and a machine with work waiting
|
||||
is told at the next login rather than left to find out.
|
||||
|
||||
The run ends with a health summary from `panama-doctor`, which reports what is
|
||||
actually running rather than what was attempted. It never fails the install: on a
|
||||
fresh machine it legitimately reports things as not yet configured.
|
||||
@@ -82,6 +89,19 @@ is what decides; anything not on it is a panel Panama owns itself.
|
||||
| `config/dot/wofi/` | Fallback launcher, in case the shell fails to start |
|
||||
| `config/dot/xdg-desktop-portal/` | Portal backend routing |
|
||||
|
||||
New machines get a welcome card on first start, teaching the handful of keys
|
||||
that matter and reachable afterwards from the launcher. `SUPER + /` shows every
|
||||
shortcut the machine has, read from the live keymap so a rebind appears there
|
||||
without anything being kept in sync. Settings carries a
|
||||
[manual](config/dot/quickshell/manual/) written for the person using the
|
||||
desktop rather than the person building it, opening with a chapter for people
|
||||
arriving from GNOME, macOS or Windows.
|
||||
|
||||
Laptops work: battery, charge limits, idle timings that differ on battery, and
|
||||
a closed lid that suspends when you are leaving and keeps working when you are
|
||||
docked. A desktop sees none of it, because every one of those surfaces hides
|
||||
when the hardware is absent.
|
||||
|
||||
**Start here: [`config/dot/hypr/README.md`](config/dot/hypr/README.md)** — it
|
||||
covers the Lua migration, the uwsm environment gotcha, the HDR decision, the
|
||||
full keymap, and troubleshooting.
|
||||
@@ -92,6 +112,7 @@ Log in as **"Hyprland (uwsm-managed)"**, not plain "Hyprland".
|
||||
|
||||
```
|
||||
bin/ Small user-facing commands on PATH; `panama` is the entry point
|
||||
migrations/ One repair per file, for machines installed before a change
|
||||
config/
|
||||
bash/ .bashrc, aliases, env (env is gitignored)
|
||||
copy/ Files copied verbatim over / (needs sudo)
|
||||
@@ -172,6 +193,9 @@ package, a `flatpak:` line is a Flathub id, `| Name` gives the menu something
|
||||
readable, and an indented line belongs to the entry above it — which is how OBS
|
||||
carries its sixteen plugin extensions as one thing to tick.
|
||||
|
||||
`panama migrate` applies repairs an installed machine has not had yet. Safe to
|
||||
re-run: nothing is applied twice, and a machine with nothing waiting says so.
|
||||
|
||||
`panama-sudo` is pkexec with a stated reason: `panama-sudo --reason "why" --
|
||||
command` shows the reason on Panama's password prompt, clearly labeled as an
|
||||
unverified claim beside polkitd's own action text — meant for agents and
|
||||
|
||||
Reference in New Issue
Block a user