feat(ui): Implement system tray with dynamic icon switching and menu controls

This commit introduces a fully functional system tray for the Mountain application, enhancing native OS integration and user accessibility. Key features include:

- A customizable system tray icon loaded from `icons/32x32.png`
- Dynamic icon switching capability via the new `SwitchTrayIcon` IPC command
- Interactive tray menu with "Open", "Hide", and "Quit" options
- Native tray event handling (e.g., left-click toggles window visibility)
- Graceful error handling for icon loading and tray operations

Additionally, this commit includes:

- Updates to `Cargo.toml` to reorder and maintain Tauri features consistently
- Enhancements to `Info.plist` for improved macOS compatibility, including specifying the app icon
- Refreshed icon assets across multiple platforms (Android, Apple, and general use)
- Minor formatting improvements in `Binary.rs` for readability

The system tray is initialized during the application setup phase and integrates seamlessly with existing components such as the localhost server and logging infrastructure.

Author: NikolaRHristov

Cargo.toml

@@ -14,11 +14,12 @@ tonic-prost-build = { workspace = true }
 
 [dependencies]
 tauri = { workspace = true, features = [
-	"wry",
-	"tray-icon",
+	"compression",
 	"devtools",
+	"image-png",
 	"rustls-tls",
-	"compression",
+	"tray-icon",
+	"wry",
 ], default-features = false }
 
 tauri-plugin-dialog = { workspace = true }

Info.plist

@@ -1,5 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
-	<dict></dict>
+    <dict>
+        <key>CSResourcesFileMapped</key>
+        <false />
+        <key>LSRequiresCarbon</key>
+        <false />
+        <key>CFBundleIconFile</key>
+        <string>icon.icns</string>
+    </dict>
 </plist>

Source/Binary.rs

@@ -3,14 +3,15 @@
 // Responsibilities:
 //   - Orchestrate the entire application lifecycle.
 //   - Initialize logging (via Tauri plugin), the Echo scheduler,
-// 	 ApplicationState, and ApplicationRunTime.
+//   ApplicationState, and ApplicationRunTime.
 //   - Serve assets via http://localhost (determined by portpicker) to support
-// 	 Service Workers.
+//   Service Workers.
 //   - Parse command-line arguments to open a workspace.
 //   - Bootstrap native command registration.
 //   - Set up the Vine gRPC server and spawn the Cocoon sidecar process.
 //   - Create and customize the main Tauri application window.
 //   - Manage the main application event loop and graceful shutdown.
+//   - [NEW] Manage System Tray and native OS integration events.
 //
 // Logging strategy:
 //   - Release default: Info (low noise) unless RUST_LOG overrides.
@@ -20,7 +21,7 @@
 //
 // NOTE (Webview logs):
 //   - To see Rust logs in the Webview console, enable TargetKind::Webview and
-// 	 call attachConsole() in the frontend.
+//   call attachConsole() in the frontend.
 
 //! # Mountain Binary Entry Point
 //!
@@ -38,7 +39,15 @@ use std::{
 
 use Echo::Scheduler::SchedulerBuilder::SchedulerBuilder;
 use log::{LevelFilter, debug, error, info, trace, warn};
-use tauri::{AppHandle, Manager, RunEvent, Wry};
+use tauri::{
+	AppHandle,
+	Manager,
+	RunEvent,
+	Wry,
+	image::Image,
+	menu::{MenuBuilder, MenuItem},
+	tray::{MouseButton, TrayIconBuilder, TrayIconEvent},
+};
 use tauri_plugin_log::{RotationStrategy, Target, TargetKind, TimezoneStrategy};
 
 use crate::{
@@ -92,6 +101,109 @@ async fn MountainGetWorkbenchConfiguration(
 	Ok(Config)
 }
 
+/// Dynamically switches the tray icon based on the theme (Light/Dark).
+/// Can be invoked from the frontend when the theme changes.
+#[tauri::command]
+fn SwitchTrayIcon(App:AppHandle, IsDarkMode:bool) {
+	debug!("[UI] [Tray] Switching icon. IsDarkMode: {}", IsDarkMode);
+
+	const DARK_ICON_BYTES:&[u8] = include_bytes!("../icons/32x32.png");
+
+	const LIGHT_ICON_BYTES:&[u8] = include_bytes!("../icons/32x32.png");
+
+	let IconBytes = if IsDarkMode { DARK_ICON_BYTES } else { LIGHT_ICON_BYTES };
+
+	if let Some(Tray) = App.tray_by_id("tray") {
+		match Image::from_bytes(IconBytes) {
+			Ok(IconImage) => {
+				if let Err(e) = Tray.set_icon(Some(IconImage)) {
+					error!("[UI] [Tray] Failed to set icon: {}", e);
+				}
+			},
+			Err(e) => error!("[UI] [Tray] Failed to load icon bytes: {}", e),
+		}
+	} else {
+		warn!("[UI] [Tray] Tray with ID 'tray' not found.");
+	}
+}
+
+// =============================================================================
+// Tray Initialization Logic
+// =============================================================================
+
+/// Configures and builds the system tray with menu and event handling.
+fn EnableTray(Application:&mut tauri::App) -> Result<(), Box<dyn std::error::Error>> {
+	let Handle = Application.handle();
+
+	// Create menu items
+	let OpenItem = MenuItem::with_id(Handle, "open", "Open Mountain", true, None::<&str>)?;
+
+	let HideItem = MenuItem::with_id(Handle, "hide", "Hide Mountain", true, None::<&str>)?;
+
+	let Separator = tauri::menu::PredefinedMenuItem::separator(Handle)?;
+
+	let QuitItem = MenuItem::with_id(Handle, "quit", "Quit", true, None::<&str>)?;
+
+	// Build menu structure
+	let TrayMenu = MenuBuilder::new(Handle)
+		.item(&OpenItem)
+		.item(&HideItem)
+		.item(&Separator)
+		.item(&QuitItem)
+		.build()?;
+
+	// Load initial icon (Defaulting to 32x32 from your icons folder)
+	let IconBytes = include_bytes!("../icons/32x32.png");
+
+	let TrayIconImage = Image::from_bytes(IconBytes)?;
+
+	// Build the Tray
+	TrayIconBuilder::with_id("tray")
+		.icon(TrayIconImage)
+		.menu(&TrayMenu)
+		.tooltip("Mountain")
+		// Handle Menu Item Clicks
+		.on_menu_event(|AppHandle, Event| match Event.id.as_ref() {
+			"open" => {
+				if let Some(Window) = AppHandle.get_webview_window("main") {
+					let _ = Window.show();
+
+					let _ = Window.set_focus();
+
+				}
+			},
+			"hide" => {
+				if let Some(Window) = AppHandle.get_webview_window("main") {
+					let _ = Window.hide();
+
+				}
+			},
+			"quit" => AppHandle.exit(0),
+			_ => warn!("[UI] [Tray] Unhandled menu item: {:?}", Event.id),
+		})
+		// Handle Native Tray Events (Left Click to Toggle)
+		.on_tray_icon_event(|Tray, Event| {
+			if let TrayIconEvent::Click { button: MouseButton::Left, .. } = Event {
+				let App = Tray.app_handle();
+
+				if let Some(Window) = App.get_webview_window("main") {
+					if Window.is_visible().unwrap_or(false) {
+						let _ = Window.hide();
+					} else {
+						let _ = Window.show();
+
+						let _ = Window.set_focus();
+					}
+				}
+			}
+		})
+		.build(Application)?;
+
+	info!("[UI] [Tray] System tray enabled successfully.");
+
+	Ok(())
+}
+
 // =============================================================================
 // Binary Entrypoint
 // =============================================================================
@@ -281,7 +393,9 @@ pub fn Fn() {
 			.plugin(tauri_plugin_localhost::Builder::new(ServerPort)
 			.on_request(|_, Response| {
 				Response.add_header("Access-Control-Allow-Origin", "*");
+
 				Response.add_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS, HEAD");
+
 				Response.add_header("Access-Control-Allow-Headers", "Content-Type, Authorization, Origin, Accept");
 			})
 			.build())
@@ -304,6 +418,17 @@ pub fn Fn() {
 
 					TraceStep!("[Lifecycle] [Setup] AppHandle acquired.");
 
+					// ---------------------------------------------------------
+					// [UI] [Tray] Initialize System Tray
+					// ---------------------------------------------------------
+					debug!("[UI] [Tray] Initializing system tray...");
+
+					if let Err(Error) = EnableTray(Application) {
+						error!("[UI] [Tray] Failed to enable tray: {}", Error);
+
+						// We do not crash the app if tray fails, but we log it.
+					}
+
 					// ---------------------------------------------------------
 					// [Lifecycle] [Commands] Bootstrap native commands
 					// ---------------------------------------------------------
@@ -437,6 +562,7 @@ pub fn Fn() {
 									);
 
 									ScanPathsGuard.push(LocalPath);
+
 								}
 							}
 
@@ -493,6 +619,7 @@ pub fn Fn() {
 			// [IPC] Command routing
 			// ---------------------------------------------------------------------
 			.invoke_handler(tauri::generate_handler![
+				SwitchTrayIcon,
 				MountainGetWorkbenchConfiguration,
 				Command::TreeView::GetTreeViewChildren,
 				Command::LanguageFeature::MountainProvideHover,
@@ -535,10 +662,8 @@ pub fn Fn() {
 							RunTime.inner().clone().Shutdown().await;
 
 							info!("[Lifecycle] [Shutdown] ApplicationRunTime stopped.");
-
 						} else {
 							error!("[Lifecycle] [Shutdown] ApplicationRunTime not found.");
-
 						}
 
 						debug!("[Lifecycle] [Shutdown] Stopping Echo scheduler...");
@@ -555,6 +680,7 @@ pub fn Fn() {
 
 						ApplicationHandleClone.exit(0);
 					});
+
 				}
 			});
 

app-icon.png

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+  <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+  <background android:drawable="@color/ic_launcher_background"/>
+</adaptive-icon>