feat: prepare Fedora x86 build support

Author: Sopwit

CHANGELOG.md

@@ -24,7 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Test suite expanded to cover monitor metric ranges and detector reporting
 - Repository metadata and packaging references aligned with the active GitHub organization
 - Privileged command flow now uses a dedicated allowlisted helper instead of raw `pkexec` command dispatch
-- GitHub release automation now targets Fedora `x86_64` and `aarch64` RPM publication from tagged builds
+- GitHub release automation now targets Fedora `i686`, `x86_64`, and `aarch64` RPM publication from tagged builds
 
 ### Fixed
 - Command execution path preserves stdout reliably
@@ -33,6 +33,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Repository cleanup for stray macOS metadata files
 - PolicyKit metadata, helper install path, and packaged action identifiers are now consistent
 - Release packaging now validates tag/CMake/spec version alignment before publishing assets
+- Fedora `i686` builds now fail fast for unsupported NVIDIA driver management flows instead of attempting broken transactions
 
 ---
 

CMakeLists.txt

@@ -269,6 +269,7 @@ message(STATUS "")
 message(STATUS "ro-control ${PROJECT_VERSION}")
 message(STATUS "  Build type : ${CMAKE_BUILD_TYPE}")
 message(STATUS "  C++ std    : C++${CMAKE_CXX_STANDARD}")
+message(STATUS "  CPU arch   : ${CMAKE_SYSTEM_PROCESSOR}")
 message(STATUS "  Qt version : ${Qt6_VERSION}")
 message(STATUS "  Install to : ${CMAKE_INSTALL_PREFIX}")
 message(STATUS "")

README.md

@@ -22,7 +22,8 @@ ro-Control is a native KDE Plasma desktop application built with **C++20** and *
 
 ## Project Status
 
-ro-Control is an active desktop utility for Fedora-first NVIDIA driver workflows.
+ro-Control is an active desktop utility for Fedora-first NVIDIA driver workflows,
+with Fedora KDE Desktop as the primary target environment.
 The current codebase focuses on:
 
 - Native Qt/QML desktop UX instead of wrapper scripts
@@ -114,7 +115,7 @@ Additional PNG screenshots should be added before wider store distribution.
 
 ### RPM Package
 
-Download the latest Fedora `.rpm` or the matching release bundle from [Releases](https://github.com/Project-Ro-ASD/ro-Control/releases), then choose the asset that matches your machine architecture (`x86_64` for 64-bit x86 systems or `aarch64` for ARM64 systems):
+Download the latest Fedora `.rpm` or the matching release bundle from [Releases](https://github.com/Project-Ro-ASD/ro-Control/releases), then choose the asset that matches your machine architecture (`i686` for 32-bit x86 systems, `x86_64` for 64-bit x86 systems, or `aarch64` for ARM64 systems):
 
 ```bash
 sudo dnf install ./ro-control-*.rpm
@@ -130,6 +131,16 @@ Fedora quick bootstrap:
 ./scripts/fedora-bootstrap.sh
 ```
 
+Native Fedora KDE Desktop `i686` build:
+
+```bash
+TARGET_ARCH=i686 ./scripts/fedora-bootstrap.sh
+```
+
+`i686` builds are supported for compilation, UI, CLI, and monitoring. Fedora
+NVIDIA driver install/update/remove flows remain available only on `x86_64` and
+`aarch64`.
+
 For Fedora-specific runtime notes, see [docs/FEDORA.md](docs/FEDORA.md).
 
 ### CLI Quick Examples

README.tr.md

@@ -22,7 +22,7 @@ ro-Control, **C++20** ve **Qt6/QML** ile geliştirilmiş, Linux üzerinde NVIDIA
 
 ## Proje Durumu
 
-ro-Control, Fedora odaklı NVIDIA sürücü iş akışları için aktif geliştirilen bir masaüstü yardımcı uygulamasıdır.
+ro-Control, Fedora odaklı NVIDIA sürücü iş akışları için aktif geliştirilen bir masaüstü yardımcı uygulamasıdır ve birincil hedef ortam Fedora KDE Desktop'tır.
 Mevcut kod tabanı özellikle şu alanlara odaklanır:
 
 - Script sarmalayıcıları yerine yerel Qt/QML masaüstü deneyimi
@@ -101,7 +101,7 @@ Daha geniş mağaza / distro dağıtımı öncesinde PNG ekran görüntüleri ek
 
 ### RPM Paketi
 
-[Releases](https://github.com/Project-Ro-ASD/ro-Control/releases) sayfasından sistem mimarinize uygun en güncel Fedora `.rpm` paketini veya release bundle dosyasını indirin (`x86_64` = 64-bit x86 sistemler, `aarch64` = ARM64 sistemler):
+[Releases](https://github.com/Project-Ro-ASD/ro-Control/releases) sayfasından sistem mimarinize uygun en güncel Fedora `.rpm` paketini veya release bundle dosyasını indirin (`i686` = 32-bit x86 sistemler, `x86_64` = 64-bit x86 sistemler, `aarch64` = ARM64 sistemler):
 
 ```bash
 sudo dnf install ./ro-control-*.rpm
@@ -117,6 +117,16 @@ Fedora hızlı kurulum:
 ./scripts/fedora-bootstrap.sh
 ```
 
+Fedora KDE Desktop üzerinde native `i686` derleme:
+
+```bash
+TARGET_ARCH=i686 ./scripts/fedora-bootstrap.sh
+```
+
+`i686` build desteği derleme, arayüz, CLI ve izleme özelliklerini kapsar.
+Fedora NVIDIA sürücü kurulum/güncelleme/kaldırma akışları ise yalnızca
+`x86_64` ve `aarch64` build'lerde etkindir.
+
 Fedora çalışma notları için [docs/FEDORA.md](docs/FEDORA.md) dosyasına bakın.
 
 ### CLI Hızlı Örnekler

docs/BUILDING.md

@@ -1,6 +1,8 @@
 # Building ro-Control from Source
 
 This guide covers building ro-Control from source on Linux systems with Qt 6 and CMake.
+The primary target is Fedora KDE Desktop, including native `i686`, `x86_64`,
+and `aarch64` builds.
 
 ---
 
@@ -23,6 +25,8 @@ This guide covers building ro-Control from source on Linux systems with Qt 6 and
 ```
 
 The script installs Fedora dependencies, builds the app, and runs tests by default.
+It auto-detects the host architecture and reports whether the resulting build is
+`i686`, `x86_64`, or `aarch64`.
 For Fedora-specific runtime notes, see [FEDORA.md](FEDORA.md).
 
 ---
@@ -43,6 +47,10 @@ sudo dnf install \
   polkit-devel
 ```
 
+On Fedora KDE Desktop `i686`, the application still builds normally, but the
+NVIDIA driver install/update/remove workflows are intentionally disabled at
+runtime because Fedora NVIDIA packages are not shipped for that architecture.
+
 Runtime tools used by diagnostics and driver operations:
 
 ```bash
@@ -76,6 +84,16 @@ cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
 cmake --build build -j$(nproc)
 ```
 
+### Native Fedora KDE Desktop x86 (`i686`) build
+
+```bash
+TARGET_ARCH=i686 ./scripts/fedora-bootstrap.sh
+```
+
+For native 32-bit Fedora hosts this is just a convenience flag. On `x86_64`
+Fedora, prefer a native `i686` builder or chroot/container when you need a real
+32-bit RPM output.
+
 ### Refresh translations (recommended before release)
 
 ```bash

docs/FEDORA.md

@@ -1,6 +1,6 @@
 # Fedora Run Guide
 
-This guide is focused on running `ro-control` on Fedora Workstation/Spin systems.
+This guide is focused on running `ro-control` on Fedora KDE Desktop / Fedora Spin systems.
 
 ## 1) Bootstrap (recommended)
 
@@ -15,6 +15,7 @@ Optional flags via environment variables:
 ```bash
 ENABLE_TESTS=0 BUILD_TYPE=Debug ./scripts/fedora-bootstrap.sh
 INSTALL_AFTER_BUILD=1 INSTALL_PREFIX=/usr ./scripts/fedora-bootstrap.sh
+TARGET_ARCH=i686 ./scripts/fedora-bootstrap.sh
 ```
 
 ## 2) Manual dependency install (equivalent)
@@ -50,6 +51,11 @@ ctest --test-dir build --output-on-failure
 ./build/ro-control
 ```
 
+If you are preparing a Fedora KDE Desktop `i686` build, use a native `i686`
+environment when possible. The bootstrap script labels the target architecture,
+but NVIDIA driver management remains disabled on `i686` because Fedora does not
+ship the required RPM Fusion NVIDIA stack there.
+
 ## 4) Install (optional)
 
 ```bash
@@ -61,6 +67,8 @@ sudo cmake --install build
 - `ro-control` invokes privileged operations through `pkexec`.
 - For proprietary NVIDIA flow, the app enables RPM Fusion and installs
   `akmod-nvidia` using `dnf`.
+- NVIDIA driver management is supported on Fedora `x86_64` and `aarch64`
+  builds. `i686` builds are supported for compilation and monitoring only.
 - A reboot is required after install/update/remove flows.
 - On Secure Boot systems, kernel module signing policy may still require manual steps.
 

docs/RELEASE.md

@@ -27,7 +27,7 @@ Use this checklist for every production release.
 ## 4. Packaging
 
 - [ ] `packaging/rpm/ro-control.spec` release/version fields are correct.
-- [ ] Build Fedora RPM artifacts successfully for both `x86_64` and `aarch64`.
+- [ ] Build Fedora RPM artifacts successfully for `i686`, `x86_64`, and `aarch64`.
 - [ ] Verify installation and launch on the target desktop environment.
 - [ ] Verify `man ro-control` and shell completions install correctly.
 - [ ] Confirm release tag version matches `CMakeLists.txt` and `packaging/rpm/ro-control.spec`.
@@ -36,7 +36,7 @@ Use this checklist for every production release.
 
 - [ ] Create annotated tag: `vX.Y.Z`.
 - [ ] Push tag to trigger release workflow.
-- [ ] Verify GitHub Release includes source archives, one `x86_64` RPM, one `aarch64` RPM, per-arch release bundles, and one source RPM.
+- [ ] Verify GitHub Release includes source archives, `i686`, `x86_64`, and `aarch64` RPMs, per-arch release bundles, and one source RPM.
 - [ ] Verify the attached checksum and RPM metadata files are present.
 
 ## 6. Post-release

packaging/rpm/README.md

@@ -7,7 +7,7 @@ This directory contains the RPM recipe for ro-Control.
 - Produce a reproducible RPM from a release tarball
 - Require translation tooling so localized builds are never emitted partially
 - Run the upstream Qt test suite during `%check`
-- Publish GitHub Release RPMs for both `x86_64` and `aarch64`
+- Publish GitHub Release RPMs for `i686`, `x86_64`, and `aarch64`
 
 ## Source archive expectations
 
@@ -58,8 +58,10 @@ Fish so command discovery works out of the box on release systems.
 The GitHub release workflow builds:
 
 - source archives (`.tar.gz`, `.zip`)
+- one Fedora binary RPM for `i686`
 - one Fedora binary RPM for `x86_64`
 - one Fedora binary RPM for `aarch64`
+- one Fedora release bundle for `i686`
 - one Fedora release bundle for `x86_64`
 - one Fedora release bundle for `aarch64`
 - one source RPM

packaging/rpm/ro-control.spec

@@ -9,7 +9,7 @@ Summary:        Smart NVIDIA driver manager and system monitor
 License:        GPL-3.0-or-later
 URL:            https://github.com/Project-Ro-ASD/ro-Control
 Source0:        %{name}-%{version}.tar.gz
-ExclusiveArch:  x86_64 aarch64
+ExclusiveArch:  i686 x86_64 aarch64
 
 BuildRequires:  cmake
 BuildRequires:  gcc-c++
@@ -77,6 +77,6 @@ tar -xzf %{SOURCE0} --strip-components=1
 
 %changelog
 * Sun Mar 22 2026 ro-Control Maintainers <noreply@github.com> - 0.1.0-1
-- Prepare first GitHub Release RPMs for x86_64 and aarch64
+- Prepare first GitHub Release RPMs for i686, x86_64, and aarch64
 - Add explicit Fedora runtime command dependencies and recommendations
 - Align RPM release automation with tagged versioned source archives

scripts/fedora-bootstrap.sh

@@ -8,6 +8,7 @@ GENERATOR="${GENERATOR:-Ninja}"
 ENABLE_TESTS="${ENABLE_TESTS:-1}"
 INSTALL_AFTER_BUILD="${INSTALL_AFTER_BUILD:-0}"
 INSTALL_PREFIX="${INSTALL_PREFIX:-/usr/local}"
+TARGET_ARCH="${TARGET_ARCH:-$(uname -m)}"
 
 build_reqs=(
   cmake
@@ -30,6 +31,23 @@ runtime_tools=(
   kmod
 )
 
+case "$TARGET_ARCH" in
+  i386|i486|i586|i686|x86)
+    TARGET_ARCH="i686"
+    ;;
+  x86_64|amd64)
+    TARGET_ARCH="x86_64"
+    ;;
+  aarch64|arm64)
+    TARGET_ARCH="aarch64"
+    ;;
+esac
+
+echo "Detected Fedora target architecture: $TARGET_ARCH"
+if [[ "$TARGET_ARCH" == "i686" ]]; then
+  echo "Preparing a 32-bit x86 Fedora build. NVIDIA driver management remains unavailable on i686."
+fi
+
 echo "[1/4] Installing Fedora build dependencies..."
 sudo dnf install -y "${build_reqs[@]}"