65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# Release snapshots
|
|
|
|
## 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:
|
|
|
|
```sh
|
|
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](https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots/src/tag/v0.1.0) and
|
|
[source archive](https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots/archive/v0.1.0.tar.gz).
|
|
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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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.
|