Fix dark theme, animation speed, kitty opacity; add README

- libadwaita apps (nautilus, gnome-text-editor) rendered light because
  gsettings-desktop-schemas + dconf were missing, so the color-scheme
  prefer-dark autostart silently no-op'd. Add both packages.
- Replace Hyprland's slow default animations with the reference laptop's
  bezier curves + per-leaf speeds (hl.curve + hl.animation).
- kitty background_opacity 0.88 -> 0.6 to match the laptop; drop the
  macOS-only background_blur line (Hyprland supplies the blur).
- Add README.md documenting the actual image, build, and test flow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,129 @@
+# BOS — Bread Operating System
+
+An Arch-based, Hyprland desktop distribution that ships the [bread
+ecosystem](https://github.com/Breadway) preconfigured. One Calamares install
+produces a themed, bootable Wayland desktop — no manual Arch bootstrap, no
+wiring up dotfiles, no per-tool bakery installs.
+
+> Design rationale and the btrfs/A-B roadmap live in [DESIGN.md](DESIGN.md).
+> This file is the practical overview: what's in the image, how to build it,
+> and how to test it.
+
+## What you get
+
+- **Compositor**: Hyprland with a native-Lua config (`hyprland.lua`), curated
+  keybinds, snappy animations, blur, and pywal-driven colours on a black base.
+- **bread ecosystem**, baked into `/etc/skel` from bakery-managed binaries
+  (no network needed at install time): `bread`/`breadd`, `breadbar` (status bar
+  + notification daemon), `breadbox` (launcher), `breadcrumbs` (Wi-Fi profiles),
+  `breadpad` (notes/reminders), `breadman`, and the `bakery` package manager.
+- **bos-settings**: a GTK4 control panel that configures every bread\* app's
+  config from a GUI (non-destructively), plus snapshot rollback and bakery
+  updates. See below.
+- **Login**: greetd + tuigreet → Hyprland session.
+- **Boot splash**: Plymouth `bos` theme (logo + spinner, black background).
+- **Theming**: global dark across GTK3 (Adwaita-dark), GTK4/libadwaita
+  (`color-scheme: prefer-dark`), and Qt (qt5ct/qt6ct Fusion dark); Papirus-Dark
+  icons; Bibata cursor.
+- **Apps**: kitty, nautilus (+ gvfs), Zen browser, VLC, loupe, gnome-text-editor,
+  gnome-calculator, file-roller, with file associations wired in `mimeapps.list`.
+- **Hardware**: pipewire audio, NetworkManager, BlueZ + blueman, CUPS printing
+  with avahi mDNS discovery, TLP power management, fwupd firmware updates.
+- **Resilience**: btrfs + snapper + snap-pac + grub-btrfs snapshots on every
+  pacman transaction; zram swap; ufw firewall (deny-incoming, mDNS allowed).
+
+## Repo layout
+
+```
+bos/
+├── Cargo.toml                     # workspace (members: bos-settings)
+├── bos-settings/                  # GTK4 unified settings app (Rust)
+│   └── src/
+│       ├── config/mod.rs          # non-destructive toml_edit config layer
+│       └── ui/{widgets,window,sidebar}.rs, ui/views/*.rs
+├── iso/                           # archiso profile
+│   ├── profiledef.sh
+│   ├── packages.x86_64            # live + installed package set
+│   └── airootfs/                  # files overlaid onto the image
+│       └── etc/
+│           ├── skel/              # default user dotfiles (hypr, kitty, gtk, …)
+│           └── calamares/         # installer config + post-install.sh
+├── packaging/                     # in-house PKGBUILDs for AUR-only deps
+│   ├── arch/                      # bos-settings
+│   ├── calamares/
+│   └── bibata/
+├── .forgejo/workflows/            # CI: build + publish packages to [breadway]
+├── build-local.sh                 # native ISO build for this machine
+└── DESIGN.md
+```
+
+## Building the ISO
+
+`build-local.sh` builds the image natively (no container) and bakes this
+machine's bakery-installed bread binaries into `/etc/skel`:
+
+```sh
+sudo ./build-local.sh              # release-quality (xz squashfs)
+sudo FAST_BUILD=1 ./build-local.sh # fast dev iteration (zstd squashfs)
+```
+
+The ISO lands in `out/bos-<date>-x86_64.iso`. The script pins
+`SOURCE_DATE_EPOCH` (reproducible UUIDs) and rewrites the `[breadway]` repo URL
+to the Tailscale-reachable Forgejo registry for the build.
+
+### Why some packages are in-house
+
+`calamares`, `zen-browser-bin`, and `bibata-cursor-theme` are AUR-only. BOS
+keeps a PKGBUILD for each under `packaging/` and republishes the built package
+to the `[breadway]` repo via a Forgejo Actions workflow (built on the hestia
+self-hosted runner, published with a scoped registry token). `bos-settings`
+itself publishes the same way on a `v*` tag.
+
+## Testing in a VM
+
+A reusable, GPU-accelerated launcher lives at `~/bos-vm/run.sh`:
+
+```sh
+~/bos-vm/run.sh install   # boot the ISO installer (target disk attached)
+~/bos-vm/run.sh           # boot the installed system from the disk
+```
+
+It uses KVM + `-cpu host`, 8 GiB / 8 vCPU, and `virtio-vga-gl` with
+`-display gtk,gl=on` (virgl) — 3D acceleration is essential for a smooth
+Hyprland session in QEMU. The disk lives on NVMe (not the tmpfs `/tmp`) to
+avoid memory pressure.
+
+## bos-settings
+
+`bos-settings` edits each bread\* app's TOML **non-destructively**: it parses
+the file with `toml_edit`, changes only the keys a view exposes, and writes it
+back — preserving comments and any keys the UI doesn't model (calendar
+passwords, saved-network passwords, model paths). Views:
+
+| View | Config |
+|------|--------|
+| bread | `bread/breadd.toml` — daemon, lua, modules, all adapters, events, notifications |
+| breadbar | `breadbar/style.css` override |
+| breadbox | `breadbox/config.toml` — launcher contexts |
+| breadcrumbs | `breadcrumbs/breadcrumbs.toml` — settings, saved networks, profiles |
+| breadpad | `breadpad/breadpad.toml` — settings, model + ollama, reminders, calendar |
+| Snapshots | `snapper` list / rollback / delete |
+| Packages | `bakery` installed list + updates |
+| Hyprland | open config in editor + monitor list |
+
+Build standalone:
+
+```sh
+cargo build --release -p bos-settings
+cargo test -p bos-settings        # includes config round-trip tests
+```
+
+## Boot architecture notes
+
+archiso keeps the kernel and initramfs outside the squashfs, so the installer
+stages them explicitly: a `shellprocess@kernel` step copies the kernel + ucode
+into the target `/boot` and writes a stock mkinitcpio preset before the native
+`initcpio` module builds the initramfs. GRUB is **not** installed by Calamares'
+`bootloader`/`grubcfg` modules (they leave the ESP empty in this layout) —
+`post-install.sh` runs `grub-install` (NVRAM **and** `--removable`) +
+`grub-mkconfig` instead, which is the sequence verified to boot.

iso/airootfs/etc/skel/.config/hypr/hyprland.lua

@@ -57,6 +57,34 @@ hl.config({
     },
 })
 
+-- ---------------------------------------------------------------------------
+-- Animations — snappy curves + per-leaf speeds (matches the reference laptop;
+-- the hl.config default above is much slower).
+-- ---------------------------------------------------------------------------
+local curves = {
+    easeOutQuint   = { type = "bezier", points = { { 0.23, 1 },    { 0.32, 1 } } },
+    easeInOutCubic = { type = "bezier", points = { { 0.65, 0.05 }, { 0.36, 1 } } },
+    almostLinear   = { type = "bezier", points = { { 0.5,  0.5 },  { 0.75, 1 } } },
+    quick          = { type = "bezier", points = { { 0.15, 0 },    { 0.1,  1 } } },
+}
+for name, curve in pairs(curves) do
+    hl.curve(name, curve)
+end
+
+local animations = {
+    { leaf = "global",     enabled = true, speed = 10,   bezier = "default" },
+    { leaf = "border",     enabled = true, speed = 5.39, bezier = "easeOutQuint" },
+    { leaf = "windows",    enabled = true, speed = 4.79, bezier = "easeOutQuint" },
+    { leaf = "windowsIn",  enabled = true, speed = 4.1,  bezier = "easeOutQuint", style = "popin 87%" },
+    { leaf = "windowsOut", enabled = true, speed = 1.49, bezier = "linear",       style = "popin 87%" },
+    { leaf = "fade",       enabled = true, speed = 3.03, bezier = "quick" },
+    { leaf = "layers",     enabled = true, speed = 3.81, bezier = "easeOutQuint" },
+    { leaf = "workspaces", enabled = true, speed = 1.94, bezier = "almostLinear", style = "fade" },
+}
+for _, animation in ipairs(animations) do
+    hl.animation(animation)
+end
+
 -- ---------------------------------------------------------------------------
 -- Environment (vendor-neutral; no GPU-specific vars so it works on Intel/AMD).
 -- ---------------------------------------------------------------------------

iso/airootfs/etc/skel/.config/kitty/kitty.conf

@@ -1,8 +1,9 @@
 # BOS kitty config.
 # Translucent background so Hyprland's blur shows through behind the terminal,
 # while text stays fully opaque. Colours are left to kitty's default / pywal.
-background_opacity 0.88
+# 0.6 matches the reference laptop; the actual blur is supplied by Hyprland's
-background_blur 1
+# decoration:blur (kitty's own background_blur is macOS-only).
+background_opacity 0.6
 
 font_family      JetBrains Mono
 font_size        11.0

iso/packages.x86_64

@@ -95,6 +95,12 @@ libpulse
 # GTK3 dark theme (Adwaita-dark); without this package the gtk-theme-name in
 # skel settings.ini silently falls back to the light theme for GTK3 apps.
 gnome-themes-extra
+# Schema + backend behind `gsettings set org.gnome.desktop.interface
+# color-scheme prefer-dark` (set in hyprland.lua autostart). Without these the
+# gsettings call fails silently and libadwaita apps (nautilus, gnome-text-editor)
+# render in LIGHT mode regardless of the GTK theme.
+gsettings-desktop-schemas
+dconf
 # Credential/keyring storage — browsers, SSH agents, and most apps persist
 # passwords here; without it every session loses saved logins. seahorse is the
 # GUI to view/manage the stored secrets and keys.