v1.6.0.6 — Documentation, Tooltips & UI Polish

Adds a Documentation button with in-app access to Quickstart Guide, User Guide,
and README. All buttons and input fields now show tooltips. Mirror button labels
are unified throughout the app. Settings left panel widened to 400px for cleaner
Full HD display.

**What's new:**
- 📖 Documentation button — opens Quickstart, User Guide or README directly in the app
- 💬 Tooltips on all buttons and input fields (Settings + Home panel)
- 🔁 Mirror labels unified: "Export to Mirror" used consistently throughout
- ⬛ Settings left column widened: 340px → 400px (no scrollbar at Full HD)
- ⬛ DATA MANAGEMENT buttons left-aligned with equal width
- 📄 QUICKSTART.txt + USER_GUIDE.txt included in all build targets

**Downloads:**
- `Garmin_Local_Archive_Standalone.zip` — recommended, no Python required
- `Garmin_Local_Archive.zip` — standard, Python 3.10+ required

[Full changelog](CHANGELOG.md)

Author: Wewoc

README.md

@@ -331,9 +331,9 @@ The project is structured into five focused layers. Each layer has a single resp
 | `garmin_app_base.py` | Assembler — fixed top (panel_home) + QTabWidget: Home / Files / Settings. PyQt6 QMainWindow. |
 | `app/garmin_app_settings.py` | Settings persistence, keyring helpers, constants. No GUI — importable in any context. |
 | `app/garmin_app_controller.py` | Application logic — ENV construction, archive stats, connection checks, timer calculations. No GUI. |
-| `app/panel_home.py` | Fixed top area: connection indicators, archive status, device table, Daily Actions (Daily Sync / Mirror / Timer). Home tab: Dashboard viewer. (v1.6.0+) |
+| `app/panel_home.py` | Fixed top area: connection indicators, archive status, device table, Daily Actions (Daily Sync / Mirror / Timer / Documentation). Home tab: Dashboard viewer. (v1.6.0+) |
 | `app/panel_settings.py` | Settings panel — credentials, paths, sync config, context location. |
-| `app/panel_connection.py` | Connection panel — connection test, dialogs, token reset. Indicators delegated to panel_home. |
+| `app/panel_connection.py` | Connection panel — connection test, data management (Export to Mirror / Import from Mirror / Restore / Silo-Check / Repair / Reset Token), dialogs. Indicators delegated to panel_home. |
 | `app/panel_archive.py` | Archive panel — integrity check, restore, clean archive, mirror operation. |
 | `app/panel_timer.py` | Timer panel — background timer UI, loop, controller delegates. |
 | `app/panel_outputs.py` | Outputs panel — sync, import, context sync, dashboard build, output buttons. |

requirements.txt

@@ -8,4 +8,7 @@ PyQt6
 PyQt6-WebEngine
 pytest
 pytest-qt
-pip-audit
+pytest-cov
+pip-audit
+ruff
+bandit

src/app/panel_archive.py

@@ -872,7 +872,7 @@ def _check():
 
             self._app._dispatch(
                 lambda: self._app._panel_connection.set_mirror_button_state(
-                    reachable, text="🔁  Data Mirror"))
+                    reachable, text="⬡  Export to Mirror"))
 
         threading.Thread(target=_check, daemon=True).start()
 
@@ -995,21 +995,21 @@ def _on_mirror(self):
         s            = self._app._panel_settings._collect_settings()
         mirror_path  = s.get("mirror_dir", "").strip()
         if not mirror_path:
-            QMessageBox.warning(self._app, "Data Mirror",
+            QMessageBox.warning(self._app, "Export to Mirror",
                                 "No mirror target configured.")
             return
         base_dir = Path(s.get("base_dir", "")).expanduser()
 
         if self._app._is_running():
-            QMessageBox.warning(self._app, "Data Mirror",
+            QMessageBox.warning(self._app, "Export to Mirror",
                 "A Garmin sync is currently running.\nPlease wait until it finishes.")
             return
         if self._app._timer_active:
-            QMessageBox.warning(self._app, "Data Mirror",
+            QMessageBox.warning(self._app, "Export to Mirror",
                 "Background timer is active.\nStop the timer before mirroring.")
             return
         if self._app._ctx_running:
-            QMessageBox.warning(self._app, "Data Mirror",
+            QMessageBox.warning(self._app, "Export to Mirror",
                 "Context sync is running.\nPlease wait until it finishes.")
             return
 
@@ -1044,7 +1044,7 @@ def _do_mirror():
                 self._mirror_running = False
                 self._app._dispatch(
                     lambda: self._app._panel_connection.set_mirror_button_state(
-                        True, text="🔁  Data Mirror"))
+                        True, text="⬡  Export to Mirror"))
 
         threading.Thread(target=_do_mirror, daemon=True).start()
 

src/app/panel_connection.py

@@ -18,7 +18,7 @@
 
 from PyQt6.QtWidgets import (
     QWidget, QVBoxLayout, QHBoxLayout, QLabel, QPushButton,
-    QDialog, QLineEdit, QFrame,
+    QDialog, QLineEdit, QFrame, QSizePolicy,
 )
 from PyQt6.QtCore import Qt, pyqtSignal, pyqtSlot
 from PyQt6.QtGui import QFont
@@ -342,11 +342,10 @@ def _build_ui(self):
 
         # Connection indicators + buttons row
         conn_row = QHBoxLayout()
-        conn_row.setSpacing(0)
+        conn_row.setSpacing(4)
 
         # _conn_indicators lives in panel_home — panel_connection delegates
         # all indicator writes via _set_indicator() → panel_home._conn_indicators.
-        conn_row.addStretch()
 
         def _btn(text, color, fg):
             b = QPushButton(text)
@@ -358,42 +357,60 @@ def _btn(text, color, fg):
                 f"QPushButton:disabled {{ color: {self._app.TEXT2}; "
                 f"background: {self._app.BG3}; }}")
             b.setCursor(Qt.CursorShape.PointingHandCursor)
+            b.setSizePolicy(QSizePolicy.Policy.Expanding, QSizePolicy.Policy.Fixed)
             return b
 
-        self._mirror_btn = _btn("🔁  Data Mirror", self._app.BG3, self._app.TEXT2)
+        self._mirror_btn = _btn("⬡  Export to Mirror", self._app.BG3, self._app.TEXT2)
         self._mirror_btn.setEnabled(False)
+        self._mirror_btn.setToolTip(
+            "Create an encrypted backup of the archive (.gla container).\n"
+            "Available after a successful connection.")
         self._mirror_btn.clicked.connect(
             lambda: self._app._panel_archive._on_mirror())
 
         self._import_mirror_btn = _btn("📥  Import from Mirror",
                                        self._app.BG3, self._app.TEXT2)
         self._import_mirror_btn.setEnabled(False)
+        self._import_mirror_btn.setToolTip(
+            "Restore data from an existing .gla mirror container.\n"
+            "Existing data with higher quality is not overwritten.")
         self._import_mirror_btn.clicked.connect(
             lambda: self._app._panel_archive._on_import_mirror())
 
         self._restore_btn = _btn("Restore Data", self._app.BG3, self._app.TEXT2)
         self._restore_btn.setEnabled(False)
+        self._restore_btn.setToolTip(
+            "Restore raw data from the backup folder.\n"
+            "Enabled after a Silo-Check detects recoverable files.")
         self._restore_btn.clicked.connect(
             lambda: self._app._panel_archive._on_restore_data())
 
         reset_btn = _btn("🔑  Reset Token", self._app.BG3, self._app.TEXT2)
+        reset_btn.setToolTip(
+            "Delete the saved Garmin session token.\n"
+            "The next sync will require a full SSO login.")
         reset_btn.clicked.connect(self._reset_token)
 
         self._silo_check_btn = _btn("🔍  Silo-Check", self._app.BG3, self._app.TEXT2)
         self._silo_check_btn.setEnabled(True)
+        self._silo_check_btn.setToolTip(
+            "Check raw/, summary/ and source/ for consistency.\n"
+            "Detects missing or mismatched files across silos.")
         self._silo_check_btn.clicked.connect(
             lambda: self._app._panel_archive._on_silo_check())
 
         self._silo_repair_btn = _btn("🔧  Repair", self._app.BG3, self._app.TEXT2)
         self._silo_repair_btn.setEnabled(False)
+        self._silo_repair_btn.setToolTip(
+            "Repair silo inconsistencies found by Silo-Check.\n"
+            "Enabled after a completed check with findings.")
         self._silo_repair_btn.clicked.connect(
             lambda: self._app._panel_archive._on_silo_repair())
 
         for b in [self._mirror_btn, self._import_mirror_btn,
                   self._restore_btn, reset_btn,
                   self._silo_check_btn, self._silo_repair_btn]:
             conn_row.addWidget(b)
-            conn_row.addSpacing(4)
 
         lay.addLayout(conn_row)
         # Archive info widgets (fail/recheck/missing/range/device-table/integrity)

src/app/panel_home.py

@@ -21,6 +21,8 @@
 """
 
 import json
+import os
+import sys
 from datetime import date
 from pathlib import Path
 
@@ -244,14 +246,24 @@ def _action_btn(text, accent=False):
             return b
 
         self._daily_sync_btn = _action_btn("▶  Daily Sync", accent=True)
+        self._daily_sync_btn.setToolTip(
+            "Download missing days from Garmin Connect.\n"
+            "Includes intraday data, daily summaries, weather and pollen.")
         self._daily_sync_btn.clicked.connect(self._on_daily_sync)
         right.addWidget(self._daily_sync_btn)
 
         self._mirror_btn = _action_btn("⬡  Mirror")
+        self._mirror_btn.setToolTip(
+            "Create an encrypted backup of the archive (.gla container).\n"
+            "Also allows importing data from an existing mirror.")
         self._mirror_btn.clicked.connect(self._on_mirror)
         right.addWidget(self._mirror_btn)
 
         self._timer_btn = _action_btn("⏱  Timer: Off")
+        self._timer_btn.setToolTip(
+            "Start the background timer.\n"
+            "Automatically syncs missing days at the configured interval\n"
+            "while the app is open.")
         self._timer_btn.setStyleSheet(
             f"QPushButton {{ background: {self._app.BG3}; color: {self._app.TEXT2}; "
             f"border: none; padding: 7px 14px; }}"
@@ -260,6 +272,12 @@ def _action_btn(text, accent=False):
             lambda: self._app._panel_timer._toggle_timer())
         right.addWidget(self._timer_btn)
 
+        self._docs_btn = _action_btn("📖  Documentation")
+        self._docs_btn.setToolTip(
+            "Open Quickstart, User Guide or README.")
+        self._docs_btn.clicked.connect(self._home_docs_dialog)
+        right.addWidget(self._docs_btn)
+
         right.addStretch()
         cols.addLayout(right, stretch=1)
 
@@ -423,6 +441,81 @@ def _on_garmin_done():
 
     # ── Mirror ─────────────────────────────────────────────────────────────────
 
+    def _home_docs_dialog(self):
+        """Documentation button handler — opens Quickstart, User Guide or README."""
+        def _open(filename: str):
+            # Dev: src/docs/  |  Build T2/T3: info/ next to EXE
+            if getattr(sys, "frozen", False):
+                base = Path(sys.executable).parent / "info"
+            else:
+                base = Path(__file__).parent.parent / "docs"
+            path = base / filename
+            if not path.exists():
+                QMessageBox.warning(
+                    self._app, "Documentation",
+                    f"File not found:\n{path}")
+                return
+            try:
+                os.startfile(path)
+            except Exception as e:
+                QMessageBox.critical(
+                    self._app, "Documentation",
+                    f"Could not open file:\n{e}")
+
+        dlg = QDialog(self._app)
+        dlg.setWindowTitle("Documentation")
+        dlg.setModal(True)
+        dlg.setFixedWidth(360)
+        dlg.setStyleSheet(
+            f"background: {self._app.BG}; color: {self._app.TEXT};")
+        lay = QVBoxLayout(dlg)
+        lay.setContentsMargins(20, 16, 20, 16)
+        lay.setSpacing(6)
+
+        title = QLabel("Documentation")
+        title.setFont(QFont("Segoe UI", 9, QFont.Weight.Bold))
+        title.setStyleSheet(f"color: {self._app.TEXT};")
+        lay.addWidget(title)
+
+        sep = QFrame()
+        sep.setFrameShape(QFrame.Shape.HLine)
+        sep.setStyleSheet(f"color: {self._app.ACCENT};")
+        sep.setFixedHeight(1)
+        lay.addWidget(sep)
+
+        for label, filename in [
+            ("📋  Quickstart",  "QUICKSTART.txt"),
+            ("📖  User Guide",  "USER_GUIDE.txt"),
+            ("📄  README App",  "README_APP.md"),
+        ]:
+            btn = QPushButton(label)
+            btn.setFont(QFont("Segoe UI", 9))
+            btn.setStyleSheet(
+                f"QPushButton {{ background: {self._app.BG3}; color: {self._app.TEXT}; "
+                f"border: none; padding: 8px 14px; text-align: left; }}"
+                f"QPushButton:hover {{ background: {self._app.ACCENT2}; }}")
+            btn.setCursor(Qt.CursorShape.PointingHandCursor)
+            _fn = filename
+            btn.clicked.connect(lambda checked, fn=_fn: [dlg.accept(), _open(fn)])
+            lay.addWidget(btn)
+
+        sep2 = QFrame()
+        sep2.setFrameShape(QFrame.Shape.HLine)
+        sep2.setStyleSheet(f"color: {self._app.BG3};")
+        lay.addWidget(sep2)
+
+        cancel_btn = QPushButton("Cancel")
+        cancel_btn.setFont(QFont("Segoe UI", 9))
+        cancel_btn.setStyleSheet(
+            f"QPushButton {{ background: {self._app.BG3}; color: {self._app.TEXT2}; "
+            f"border: none; padding: 7px 14px; }}"
+            f"QPushButton:hover {{ background: {self._app.ACCENT2}; }}")
+        cancel_btn.setCursor(Qt.CursorShape.PointingHandCursor)
+        cancel_btn.clicked.connect(dlg.reject)
+        lay.addWidget(cancel_btn)
+
+        dlg.exec()
+
     def _on_mirror(self):
         """Mirror button handler. Main Thread only."""
         s = self._app._panel_settings._collect_settings()
@@ -435,7 +528,7 @@ def _on_mirror(self):
     def _home_mirror_dialog_no_target(self):
         """Dialog shown when no mirror target is configured."""
         dlg = QDialog(self._app)
-        dlg.setWindowTitle("Mirror")
+        dlg.setWindowTitle("Export to Mirror")
         dlg.setModal(True)
         dlg.setFixedWidth(460)
         dlg.setStyleSheet(
@@ -549,7 +642,7 @@ def _save_and_continue():
     def _home_mirror_dialog_with_target(self, mirror_dir: str):
         """Dialog shown when mirror target is already configured."""
         dlg = QDialog(self._app)
-        dlg.setWindowTitle("Mirror")
+        dlg.setWindowTitle("Export to Mirror")
         dlg.setModal(True)
         dlg.setFixedWidth(380)
         dlg.setStyleSheet(
@@ -558,7 +651,7 @@ def _home_mirror_dialog_with_target(self, mirror_dir: str):
         lay.setContentsMargins(20, 16, 20, 16)
         lay.setSpacing(6)
 
-        title = QLabel("Mirror")
+        title = QLabel("Export to Mirror")
         title.setFont(QFont("Segoe UI", 9, QFont.Weight.Bold))
         title.setStyleSheet(f"color: {self._app.TEXT};")
         lay.addWidget(title)

src/app/panel_outputs.py

@@ -208,6 +208,7 @@ def _tip(self, text: str) -> QLabel:
         lbl = QLabel(text)
         lbl.setFont(QFont("Segoe UI", 8))
         lbl.setStyleSheet(f"color: {self._app.TEXT2};")
+        lbl.setFixedWidth(300)
         return lbl
 
     # ── Sync actions ───────────────────────────────────────────────────────────