feat: add native desktop GUI and installation support with desktop entry

Author: AdmGenSameer

README.md

@@ -155,10 +155,15 @@ After installation, the CLI is available as `archpkg`.
 ArchPkg Helper provides a professional native desktop application for graphical package management:
 
 ```sh
-# Launch the GUI (works immediately after install.sh)
+# Launch from command line
 archpkg gui
+
+# Or find it in your application menu
+# Look for "archpkg helper" in System/Package Manager category
 ```
 
+The GUI appears in your desktop environment's application menu (GNOME Activities, KDE Application Menu, XFCE Application Finder, etc.) after installation.
+
 **GUI Features:**
 - **Search & Install Tab**: Search packages across all sources with real-time trust scores
   - Visual trust indicators (color-coded)

archpkg-helper.desktop

@@ -0,0 +1,13 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=archpkg helper
+GenericName=Package Manager
+Comment=Cross-distribution package manager with GUI
+Exec=archpkg gui
+Icon=system-software-install
+Terminal=false
+Categories=System;PackageManager;Settings;
+Keywords=package;install;update;software;pacman;apt;dnf;aur;flatpak;snap;
+StartupNotify=true
+StartupWMClass=archpkg-helper

install.sh

@@ -240,6 +240,47 @@ EOF
     echo "[✔] Profile configured: $ARCHPKG_USER_MODE"
 fi
 
+##############################################
+# 9. Install desktop entry for GUI
+##############################################
+echo "[*] Installing desktop application entry…"
+
+DESKTOP_DIR="$HOME/.local/share/applications"
+mkdir -p "$DESKTOP_DIR"
+
+# Try to copy from repo if available, otherwise create directly
+if [ -f "archpkg-helper.desktop" ]; then
+    cp archpkg-helper.desktop "$DESKTOP_DIR/archpkg-helper.desktop"
+    echo "[✔] Desktop entry installed from local file"
+else
+    # Create desktop entry directly
+    cat > "$DESKTOP_DIR/archpkg-helper.desktop" <<'DESKTOP_EOF'
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=archpkg helper
+GenericName=Package Manager
+Comment=Cross-distribution package manager with GUI
+Exec=archpkg gui
+Icon=system-software-install
+Terminal=false
+Categories=System;PackageManager;Settings;
+Keywords=package;install;update;software;pacman;apt;dnf;aur;flatpak;snap;
+StartupNotify=true
+StartupWMClass=archpkg-helper
+DESKTOP_EOF
+    echo "[✔] Desktop entry created"
+fi
+
+chmod +x "$DESKTOP_DIR/archpkg-helper.desktop"
+
+# Update desktop database if available
+if command -v update-desktop-database >/dev/null 2>&1; then
+    update-desktop-database "$DESKTOP_DIR" >/dev/null 2>&1 || true
+fi
+
+echo "[✔] GUI will appear in application menu"
+
 ##############################################
 # DONE
 ##############################################
@@ -250,4 +291,5 @@ echo "    archpkg --help       # Show all CLI commands"
 echo "    archpkg gui          # Launch native desktop GUI"
 echo "    archpkg search <pkg> # Search for packages"
 echo ""
-echo "Both CLI and GUI are now available!"
+echo "The GUI is also available in your application menu!"
+echo "Look for 'archpkg helper' in System/Package Manager category."

GUI_GUIDE.md notes/GUI_GUIDE.mdGUI_GUIDE.md renamed to notes/GUI_GUIDE.md

@@ -39,10 +39,18 @@ pipx install archpkg[all]  # includes all optional features
 
 ## Launching the GUI
 
+**From command line:**
 ```bash
 archpkg gui
 ```
 
+**From application menu:**
+Look for "archpkg helper" in your desktop environment's application menu:
+- **GNOME**: Search for "archpkg" in Activities
+- **KDE Plasma**: Find in Application Menu → System → Package Manager
+- **XFCE**: Application Finder → System → Package Manager
+- **Other DEs**: Check System or Package Manager category
+
 ## Interface Overview
 
 The GUI consists of 4 main tabs:

GUI_IMPLEMENTATION.md notes/GUI_IMPLEMENTATION.mdGUI_IMPLEMENTATION.md renamed to notes/GUI_IMPLEMENTATION.md

@@ -32,3 +32,6 @@ packages = ["archpkg"]
 
 [tool.setuptools.package-data]
 archpkg = ["*.yaml", "*.yml", "*.json", "templates/*.html", "templates/**/*"]
+
+[tool.setuptools.data-files]
+"share/applications" = ["archpkg-helper.desktop"]