tauri-app-positioner

When to use this skill

ALWAYS use this skill when the user mentions:

• Positioning windows near the system tray
• Multi-monitor or multi-display window alignment
• Consistent window placement across platforms

Trigger phrases include:

• "positioner", "window position", "tray window", "multi-monitor", "align window"

How to use this skill

1. Install the positioner plugin:

   cargo add tauri-plugin-positioner
   

2. Register the plugin in your Tauri builder:

   use tauri_plugin_positioner::Position;
   tauri::Builder::default()
       .plugin(tauri_plugin_positioner::init())
   

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

   { "permissions": ["positioner:allow-move-window"] }
   

4. Position a window from the frontend:

   import { moveWindow, Position } from '@tauri-apps/plugin-positioner';
   await moveWindow(Position.TrayCenter);    // center below tray icon
   await moveWindow(Position.TopRight);      // top-right corner of screen
   await moveWindow(Position.BottomRight);   // bottom-right corner
   

5. Handle multi-display by checking which monitor the tray icon is on and positioning relative to it
6. Account for scaling factors on HiDPI displays that affect coordinate calculations

Outputs

• Positioner plugin setup with Position enum
• Tray-relative and screen-relative positioning
• Multi-display and HiDPI scaling guidance

References

• https://v2.tauri.app/plugin/positioner/

Keywords

tauri positioner, window position, tray window, multi-monitor, align