Fiw-Gentoo-Dots/docs/releases.md

4.7 KiB

Release snapshots

v0.1.2 — Editor themes and device selections

Neovim's optional config now includes the pinned Catppuccin runtime, and VS Code includes the ayu MiDas 1.1.0 colour-theme extension. Both retain upstream licences and work without fetching their themes during installation. Neovim keeps the captured transparent purple highlights and its fallback.

The final TUI preview adds n to save a named device selection. Saved devices appear on the preset screen, retaining their build profile and package/config choices. Files stay under ignored local/devices. CLI --device, --save-device and --list-devices support the same workflow. Selective capture now accepts --config for one or several presets, with --list showing supported selections. VS Code capture uses explicit preference keys and omits machine-specific Java runtimes.

The matching prebuilt TUI is included in the tag and source archive. See device presets, recapture and app config scope.

v0.1.1 — Config update review

Adds e for config updates and p for pending changes in the final TUI preview. Each pending file has a diff and an acceptance prompt. Accepting backs up the current file and rechecks that it has not changed since the proposal was created. Manually edited proposals remain local preferences on future updates. Selected patches for shared KDE files produce one combined proposal containing both styling and shortcut adjustments.

git clone --branch v0.1.1 https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots.git
cd Fiw-Gentoo-Dots
./install

The matching prebuilt Linux amd64 TUI is included in the tag and source archive. See config updates for the review flow and CLI commands.

v0.1.0 — First restoration snapshot

This tag captures the current KDE shortcuts and appearance, categorized packages, individually optional app preferences and restoration interface. Use the snapshot when restoring another device:

git clone --branch v0.1.0 https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots.git
cd Fiw-Gentoo-Dots
./install

The repository includes a compressed, static Linux amd64 TUI binary. The launcher verifies its archive, executable and frontend source fingerprints before use, then caches the executable in ignored build/. Git and Python 3.11+ are sufficient for the bundled TUI. The Python backend remains readable and runs directly for CLI commands.

Downloads are available through the Forgejo tag and source archive. The archive includes the binary, checksums and upstream licence notices. This is a Git-tagged snapshot; no separate Forgejo release attachment is needed.

Included in this snapshot:

  • Exact personal KDE shortcut assignments and optional KDE/GTK styling.
  • Stock and Fiw's Ryzen presets with categorized packages and binary preference.
  • Independent app configs, user Flatpaks and optional service selections.
  • Config requirements, conflict prompts, backup restoration and combined reports.
  • Optional Limine/GRUB deployment with target preview and firmware choices.
  • A refreshed optional TideWM recipe and an audit covering all current explicit selections.

The installer starts from an existing Gentoo system. Boot automation covers unsigned amd64 UEFI and plain ext4/Btrfs roots. A full fresh-system package and boot run remains unverified. TideWM is a live source package, separately optional and subject to the compile-or-skip prompt.

Source fallback and maintenance

Go 1.24+ is needed when the binary is absent, unsupported on the current architecture, or does not match changed frontend source. To explicitly build:

FIW_DOTS_SOURCE=1 ./install

The source fallback does not download a newer Go toolchain automatically. Config-only changes retain the frontend fingerprint, so recapturing app preferences does not require rebuilding the binary.

Before tagging a new snapshot, update VERSION and rebuild the bundle:

python3 tools/build-release.py
python3 tools/check-private.py

The maintainer build uses CGO_ENABLED=0, generic amd64 instructions, -trimpath and no Git build metadata. It records archive/executable/source SHA256 fingerprints and retains notices for the Go dependencies used in that binary and for the Go runtime. Review and commit the generated assets/bin/ files with the matching frontend source, then tag that commit.