Agent Skills: tauri-app-window-state

When to use this skill

ALWAYS use this skill when the user mentions:

• Remembering window size and position between sessions
• StateFlags configuration for window state persistence
• Restoring window state on multi-display setups

Trigger phrases include:

• "window state", "remember window size", "restore position", "StateFlags", "persist window"

How to use this skill

1. Install the window-state plugin:

   cargo add tauri-plugin-window-state
   

2. Register the plugin with desired StateFlags:

   use tauri_plugin_window_state::{AppHandleExt, StateFlags};
   tauri::Builder::default()
       .plugin(tauri_plugin_window_state::Builder::new()
           .with_state_flags(StateFlags::SIZE | StateFlags::POSITION | StateFlags::MAXIMIZED)
           .build())
   

3. Configure capabilities in src-tauri/capabilities/default.json:

   { "permissions": ["window-state:allow-restore-state", "window-state:allow-save-window-state"] }
   

4. State is restored automatically on app startup for each window
5. Choose StateFlags carefully: SIZE, POSITION, MAXIMIZED, VISIBLE, DECORATIONS, FULLSCREEN
6. Handle multi-display edge cases where a saved position may be off-screen if the display layout changed

Outputs

• Window-state plugin setup with StateFlags
• Automatic save/restore configuration
• Multi-display edge case handling

References

• https://v2.tauri.app/plugin/window-state/

Keywords

tauri window state, persist window, restore position, StateFlags, window size