Enhance build process and GUI for Path Juggler. Updated build script to use Nuitka for creating a standalone macOS app. Added .DS_Store and build artifacts to .gitignore. Refactored GUI to utilize PySide6, improving layout and styling. Updated logging mechanism for thread-safe operations and enhanced status indicators.

DEBUGGING.md

@@ -0,0 +1,118 @@
+# Debugging Path Juggler
+
+## Build System
+
+The build scripts use **uv** to manage Python versions and dependencies, ensuring a truly self-contained build that doesn't depend on system Python installations. This means:
+- ✅ No dependency on system Python versions
+- ✅ No dependency on Homebrew Python
+- ✅ Consistent builds across different systems
+- ✅ Self-contained .app bundle with everything included
+
+## The Problem
+
+When you launch the built app and nothing happens, it's because:
+1. The app is built with `console=False`, so errors are hidden
+2. The app is failing silently due to missing dependencies (like `tkinter`)
+
+## Solution 1: Run from Terminal (Quick Debug)
+
+Run the existing app from terminal to see errors:
+
+```bash
+./run_app_debug.sh
+```
+
+Or manually:
+```bash
+"/Users/justinaspetravicius/Public/Gitea/path-juggler/dist/Path Juggler.app/Contents/MacOS/Path Juggler"
+```
+
+This will show you any error messages in the terminal.
+
+## Solution 2: Build Debug Version
+
+Build a version with console output enabled:
+
+```bash
+./build_app_debug.sh
+```
+
+This creates `Path Juggler Debug.app` which will show a terminal window with all output.
+
+## Solution 3: Check System Logs
+
+On macOS, you can also check system logs:
+
+```bash
+# View recent logs for the app
+log show --predicate 'process == "Path Juggler"' --last 5m
+
+# Or use Console.app (GUI)
+open -a Console
+```
+
+## Common Issues Found
+
+### Issue: Missing tkinter
+
+**Error:** `ModuleNotFoundError: No module named 'tkinter'` or `ModuleNotFoundError: No module named '_tkinter'`
+
+**Root Cause:** The build scripts now use `uv` to install Python 3.12, which includes tkinter by default. If you still see this error, it may be a PyInstaller bundling issue.
+
+**Fix:** The build scripts use `uv` to:
+1. Install Python 3.12 (which has tkinter built-in)
+2. Create a virtual environment with that Python
+3. Install all dependencies
+4. Build with PyInstaller (which bundles everything including tkinter)
+
+Rebuild the app:
+```bash
+./build_app.sh
+```
+
+**If tkinter is still missing:**
+1. Make sure `uv` is installed: `brew install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh`
+2. The build script will automatically download Python 3.12 if needed
+3. PyInstaller should bundle tkinter automatically - if not, check the PyInstaller output for warnings
+
+### Issue: Missing watchdog modules
+
+**Error:** `ModuleNotFoundError: No module named 'watchdog.observers.fsevents'`
+
+**Fix:** Make sure watchdog is installed in the build environment. The build script handles this automatically.
+
+## Rebuilding After Fixes
+
+After fixing issues, rebuild:
+
+```bash
+# Production build (no console)
+./build_app.sh
+
+# Debug build (with console)
+./build_app_debug.sh
+```
+
+## Testing the Fix
+
+After rebuilding, test:
+
+1. **Quick test from terminal:**
+   ```bash
+   ./run_app_debug.sh
+   ```
+
+2. **Or launch the debug version:**
+   ```bash
+   open "dist/Path Juggler Debug.app"
+   ```
+
+3. **Or launch the production version:**
+   ```bash
+   open "dist/Path Juggler.app"
+   ```
+
+## Current Status
+
+The build scripts have been updated to include `tkinter` in the hidden imports. You should rebuild the app to apply the fix.
+