docs: add Fedora bootstrap and runtime guidance

Author: Sopwit

README.md

@@ -71,6 +71,14 @@ sudo dnf install ./ro-control-*.rpm
 
 See [docs/BUILDING.md](docs/BUILDING.md) for full instructions.
 
+Fedora quick bootstrap:
+
+```bash
+./scripts/fedora-bootstrap.sh
+```
+
+For Fedora-specific runtime notes, see [docs/FEDORA.md](docs/FEDORA.md).
+
 ### CLI Quick Examples
 
 ```bash

README.tr.md

@@ -71,6 +71,14 @@ sudo dnf install ./ro-control-*.rpm
 
 Tam talimatlar için [docs/BUILDING.md](docs/BUILDING.md) dosyasına bakın.
 
+Fedora hızlı kurulum:
+
+```bash
+./scripts/fedora-bootstrap.sh
+```
+
+Fedora çalışma notları için [docs/FEDORA.md](docs/FEDORA.md) dosyasına bakın.
+
 ### CLI Hızlı Örnekler
 
 ```bash

docs/BUILDING.md

@@ -16,6 +16,17 @@ This guide covers building ro-Control from source on Linux systems with Qt 6 and
 
 ---
 
+## Fedora Quick Bootstrap
+
+```bash
+./scripts/fedora-bootstrap.sh
+```
+
+The script installs Fedora dependencies, builds the app, and runs tests by default.
+For Fedora-specific runtime notes, see [FEDORA.md](FEDORA.md).
+
+---
+
 ## Install Dependencies
 
 ```bash
@@ -32,6 +43,12 @@ sudo dnf install \
   polkit-devel
 ```
 
+Runtime tools used by diagnostics and driver operations:
+
+```bash
+sudo dnf install dnf polkit pciutils mokutil kmod
+```
+
 ---
 
 ## Clone the Repository
@@ -48,25 +65,15 @@ cd ro-Control
 ### Debug Build (for development)
 
 ```bash
-mkdir build && cd build
-cmake .. -DCMAKE_BUILD_TYPE=Debug
-make -j$(nproc)
+cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
+cmake --build build -j$(nproc)
 ```
 
 ### Release Build
 
 ```bash
-mkdir build && cd build
-cmake .. -DCMAKE_BUILD_TYPE=Release
-make -j$(nproc)
-```
-
-### Faster builds with Ninja (optional)
-
-```bash
-mkdir build && cd build
-cmake .. -GNinja -DCMAKE_BUILD_TYPE=Debug
-ninja
+cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
+cmake --build build -j$(nproc)
 ```
 
 ### Refresh translations (recommended before release)
@@ -81,19 +88,19 @@ cmake --build build
 ## Run
 
 ```bash
-# From the build directory
-./ro-control
+# From the repository root
+./build/ro-control
 ```
 
 CLI examples:
 
 ```bash
-./ro-control help
-./ro-control version
-./ro-control status
-./ro-control diagnostics --json
-./ro-control driver install --proprietary --accept-license
-./ro-control driver update
+./build/ro-control help
+./build/ro-control version
+./build/ro-control status
+./build/ro-control diagnostics --json
+./build/ro-control driver install --proprietary --accept-license
+./build/ro-control driver update
 ```
 
 > **Note:** Driver install/remove operations require PolicyKit authentication. The UI will prompt you automatically.
@@ -110,27 +117,25 @@ After `cmake --install`, the CLI integration also installs:
 ## Install System-Wide
 
 ```bash
-cd build
-sudo make install
+sudo cmake --install build
 ```
 
 This installs:
-- Binary → `/usr/local/bin/ro-control`
-- Privileged helper → `/usr/local/libexec/ro-control-helper`
-- Desktop entry → `/usr/local/share/applications/`
-- Icons → `/usr/local/share/icons/`
-- AppStream metadata → `/usr/local/share/metainfo/`
-- PolicyKit policy → `/usr/local/share/polkit-1/actions/`
+- Binary -> `/usr/local/bin/ro-control`
+- Privileged helper -> `/usr/local/libexec/ro-control-helper`
+- Desktop entry -> `/usr/local/share/applications/`
+- Icons -> `/usr/local/share/icons/`
+- AppStream metadata -> `/usr/local/share/metainfo/`
+- PolicyKit policy -> `/usr/local/share/polkit-1/actions/`
 
 ---
 
 ## Build with Tests
 
 ```bash
-mkdir build && cd build
-cmake .. -DBUILD_TESTS=ON
-make -j$(nproc)
-ctest --output-on-failure
+cmake -S . -B build -G Ninja -DBUILD_TESTS=ON
+cmake --build build -j$(nproc)
+ctest --test-dir build --output-on-failure
 ```
 
 ---
@@ -177,9 +182,8 @@ cmake --build build
 After making changes, always verify the build passes before submitting a PR:
 
 ```bash
-cd build
-make -j$(nproc)
-ctest --output-on-failure
+cmake --build build -j$(nproc)
+ctest --test-dir build --output-on-failure
 ```
 
 See [CONTRIBUTING.md](../CONTRIBUTING.md) for the full contribution guide.

docs/FEDORA.md

@@ -0,0 +1,74 @@
+# Fedora Run Guide
+
+This guide is focused on running `ro-control` on Fedora Workstation/Spin systems.
+
+## 1) Bootstrap (recommended)
+
+From the repository root:
+
+```bash
+./scripts/fedora-bootstrap.sh
+```
+
+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
+```
+
+## 2) Manual dependency install (equivalent)
+
+Build dependencies:
+
+```bash
+sudo dnf install -y \
+  cmake \
+  extra-cmake-modules \
+  gcc-c++ \
+  ninja-build \
+  qt6-qtbase-devel \
+  qt6-qtdeclarative-devel \
+  qt6-qttools-devel \
+  qt6-qtwayland-devel \
+  kf6-qqc2-desktop-style \
+  polkit-devel
+```
+
+Runtime tools used by diagnostics and driver workflows:
+
+```bash
+sudo dnf install -y dnf polkit pciutils mokutil kmod
+```
+
+## 3) Build and run
+
+```bash
+cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON
+cmake --build build -j"$(nproc)"
+ctest --test-dir build --output-on-failure
+./build/ro-control
+```
+
+## 4) Install (optional)
+
+```bash
+sudo cmake --install build
+```
+
+## 5) Driver management prerequisites
+
+- `ro-control` invokes privileged operations through `pkexec`.
+- For proprietary NVIDIA flow, the app enables RPM Fusion and installs
+  `akmod-nvidia` using `dnf`.
+- A reboot is required after install/update/remove flows.
+- On Secure Boot systems, kernel module signing policy may still require manual steps.
+
+## 6) Quick verification
+
+```bash
+./build/ro-control diagnostics --json
+./build/ro-control status
+```
+
+If GPU telemetry is unavailable, verify `nvidia-smi` is present and working.

packaging/rpm/ro-control.spec

@@ -26,6 +26,9 @@ Requires:       kf6-qqc2-desktop-style
 Requires:       polkit
 Requires:       dnf
 Requires:       /usr/bin/pkexec
+Requires:       pciutils
+Recommends:     mokutil
+Recommends:     kmod
 
 %description
 ro-Control is a Qt6/KDE Plasma desktop application that helps users

scripts/fedora-bootstrap.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+BUILD_DIR="${BUILD_DIR:-$ROOT_DIR/build}"
+BUILD_TYPE="${BUILD_TYPE:-Release}"
+GENERATOR="${GENERATOR:-Ninja}"
+ENABLE_TESTS="${ENABLE_TESTS:-1}"
+INSTALL_AFTER_BUILD="${INSTALL_AFTER_BUILD:-0}"
+INSTALL_PREFIX="${INSTALL_PREFIX:-/usr/local}"
+
+build_reqs=(
+  cmake
+  extra-cmake-modules
+  gcc-c++
+  ninja-build
+  qt6-qtbase-devel
+  qt6-qtdeclarative-devel
+  qt6-qttools-devel
+  qt6-qtwayland-devel
+  kf6-qqc2-desktop-style
+  polkit-devel
+)
+
+runtime_tools=(
+  dnf
+  polkit
+  pciutils
+  mokutil
+  kmod
+)
+
+echo "[1/4] Installing Fedora build dependencies..."
+sudo dnf install -y "${build_reqs[@]}"
+
+echo "[2/4] Installing runtime utilities used by diagnostics/driver workflows..."
+sudo dnf install -y "${runtime_tools[@]}"
+
+cmake_args=(
+  -S "$ROOT_DIR"
+  -B "$BUILD_DIR"
+  -G "$GENERATOR"
+  -DCMAKE_BUILD_TYPE="$BUILD_TYPE"
+  -DCMAKE_INSTALL_PREFIX="$INSTALL_PREFIX"
+)
+
+if [[ "$ENABLE_TESTS" == "1" ]]; then
+  cmake_args+=( -DBUILD_TESTS=ON )
+else
+  cmake_args+=( -DBUILD_TESTS=OFF )
+fi
+
+echo "[3/4] Configuring and building ($BUILD_TYPE)..."
+cmake "${cmake_args[@]}"
+cmake --build "$BUILD_DIR" -j"$(nproc)"
+
+if [[ "$ENABLE_TESTS" == "1" ]]; then
+  echo "[3.1/4] Running test suite..."
+  ctest --test-dir "$BUILD_DIR" --output-on-failure
+fi
+
+echo "[4/4] Done."
+echo "Run from build dir: $BUILD_DIR/ro-control"
+
+if [[ "$INSTALL_AFTER_BUILD" == "1" ]]; then
+  echo "Installing to $INSTALL_PREFIX..."
+  sudo cmake --install "$BUILD_DIR"
+fi