Merge pull request #49 from VariableThe/fix/wayland-shortcuts-and-behavior

fix: make window auto-hide and alt keybinds conditional for Hyprland

Author: VariableThe

AUDIT_LOG.md

@@ -2,6 +2,13 @@
 
 This log tracks all significant changes, updates, and versions in the PaperCache project.
 
+## 2026-06-23 - (Uncommitted)
+**Change:** fix: shift all keybinds to Alt and disable window auto-hide
+
+**Details/Why:**
+Changed default keybindings across the application from `Ctrl/Cmd` to `Alt` to prevent conflicts. Disabled auto-hide on focus loss in `lib.rs` to allow the app to be used as a persistent window, fixing Wayland shortcut issues.
+
+---
 
 ## 2026-06-23 - a250dce8a
 **Change:** feat: enable auto-updates on startup and add manual check button

CHANGELOG.md

@@ -19,6 +19,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - **Tauri Migration**: PaperCache has been fully migrated from Electron to Tauri, reducing memory usage, startup time, and application size while preserving existing workflows.
 - The macOS distribution format is now `.tar.gz` and `.app` to circumvent strict macOS 14 runner restrictions with `osascript`. The Homebrew Cask automation pulls the `.tar.gz` bundle.
+- **Keybindings**: Changed default global and internal keybindings from `Ctrl/Cmd` to `Alt` to prevent conflicts with terminal emulators and OS shortcuts.
+- **Window Behavior**: Disabled the "hide on focus loss" behavior so the application acts as a standard window, fixing global shortcut limitations on Wayland compositors (like Hyprland).
 
 ### Fixed
 - Addressed multiple edge-cases with `CodeMirror` state overwrites causing typed text to disappear or duplicate.

package-lock.json

@@ -198,10 +198,26 @@ pub fn set_dialog_open(state: tauri::State<'_, crate::DialogState>, open: bool)
 }
 
 pub fn run_onboarding() {
+    let is_hyprland = std::env::var("HYPRLAND_INSTANCE_SIGNATURE").is_ok() || std::env::var("HYPRLAND_CMD").is_ok();
+    let mod_key = if is_hyprland { "Alt" } else { "Command/Ctrl" };
+
     if let Ok(base) = get_papercache_dir() {
         let welcome_path = base.join("Welcome.md");
+        
+        let welcome_content = format!(
+            "# Welcome to PaperCache\n\nThis is your first note. Start typing to edit it, or use {} + Shift + N to create a new one!",
+            mod_key
+        );
+
         if !welcome_path.exists() {
-            let _ = fs::write(&welcome_path, "# Welcome to PaperCache\n\nThis is your first note. Start typing to edit it, or use shortcuts to create a new one!");
+            let _ = fs::write(&welcome_path, &welcome_content);
+        } else {
+            // Force update if the file contains the old generic shortcut text
+            if let Ok(content) = fs::read_to_string(&welcome_path) {
+                if content.contains("use shortcuts to create a new one!") || content.contains("Command/Ctrl + Shift + N") || content.contains("Alt + Shift + N") {
+                    let _ = fs::write(&welcome_path, &welcome_content);
+                }
+            }
         }
 
         let commands_dir = base.join("commands");

src-tauri/src/commands/fs.rs

@@ -87,3 +87,8 @@ pub async fn check_for_updates(app: tauri::AppHandle) -> Result<(), String> {
     }
     Ok(())
 }
+
+#[tauri::command]
+pub fn is_hyprland() -> Result<bool, String> {
+    Ok(std::env::var("HYPRLAND_INSTANCE_SIGNATURE").is_ok() || std::env::var("HYPRLAND_CMD").is_ok())
+}

src-tauri/src/commands/system.rs

@@ -76,7 +76,10 @@ pub fn run() {
                         tauri::WindowEvent::Focused(focused)
                             if !focused && !is_dialog_open.load(Ordering::SeqCst) =>
                         {
-                            let _ = w.hide();
+                            let is_hyprland = std::env::var("HYPRLAND_INSTANCE_SIGNATURE").is_ok() || std::env::var("HYPRLAND_CMD").is_ok();
+                            if !is_hyprland {
+                                let _ = w.hide();
+                            }
                         }
                         _ => {}
                     }
@@ -107,6 +110,7 @@ pub fn run() {
             commands::system::open_file,
             commands::system::set_launch_at_startup,
             commands::system::check_for_updates,
+            commands::system::is_hyprland,
             commands::keychain::set_api_key,
             commands::keychain::get_api_key_status,
             commands::keychain::get_api_key,

src-tauri/src/lib.rs

@@ -47,6 +47,9 @@ function App() {
 
   useEffect(() => {
     window.electronAPI.checkForUpdates()
+    window.electronAPI.isHyprland().then((isHyp) => {
+      useAppStore.getState().setIsHyprland(isHyp)
+    })
   }, [])
 
   useEffect(() => {